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INITIAL INSPECTION 



WARRANTY 



PRODUCT ASSISTANCE 



MAINTENANCE 

AGREEMENTS 



GENERAL INFORMATION 



It is recommended that the shipment be thoroughly inspected im- 
mediately upon delivery to the purchaser. All material in the 
container should be checked against the enclosed Packing List. 
LeCroy cannot accept responsibility for shortages in comparison 
with the Packing List unless notified promptly. If the shipment is 
damaged in any way, please contact the Customer Service Depart- 
ment or local field office immediately. 

LeCroy warrants its oscilloscope products to operate within specifi- 
cations under normal use for a period of two years from the date of 
shipment. Spares, replacement parts and repairs are warranted for 
90 days. The instrument’s firmware is thoroughly tested and 
thought to be functional, but is supplied “as is” with no warranty of 
any kind covering detailed performance. Products not manufac- 
tured by LeCroy are covered solely by the warranty of the original 
equipment manufacturer. 

In exercising this warranty, LeCroy will repair or, at its option, 
replace any product returned to the Customer Service Department 
or an authorized service facility within the warranty period, pro- 
vided that the warrantor’s examination discloses that the product 
is defective due to workmanship or materials and that the defect 
has not been caused by misuse, neglect, accident or abnormal con- 
ditions or operation. 

The purchaser is responsible for the transportation and insurance 
charges arising from the return of products to the servicing facility. 
LeCroy will return all in-warranty products with transportation 
prepaid. 

This warranty is in lieu of all other warranties, expressed or im- 
plied, including but not limited to any implied warranty of 
merchantability, fitness, or adequacy for any particular purpose or 
use. LeCroy shall not be liable for any special, incidental, or con- 
sequential damages, whether in contract or otherwise. 

Answers to questions concerning installation, calibration, and use 
of LeCroy equipment are available from the Customer Service De- 
partment, 700 Chestnut Ridge Road, Chestnut Ridge, New York 
10977-6499, U.S.A., tel. (914)578-6059, and 2, chemin Pre- 
de-la-Fontaine, 1217 Meyrin 1, Geneva, Switzerland, tel. 
(41)22/719 21 11, or your local field engineering office. 



LeCroy offers a selection of customer support services. For exam- 
ple, maintenance agreements provide extended warranty and 
allow the customer to budget maintenance costs after the initial 
two year warranty has expired. Other services requested by the 
customer such as installation, training, on-site repair, and addi- 
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| General Information 



DOCUMENTATION 

DISCREPANCIES 



SERVICE PROCEDURE 



RETURN PROCEDURE 



tion of engineering improvements are made available through 
specific Supplemental Support Agreements. 

LeCroy is committed to providing state-of-the-art instrumenta- 
tion and is continually refining and improving the performance of 
its products. While physical modifications can be implemented 
quite rapidly, the corrected documentation frequently requires 
more time to produce. Consequently, this manual may not agree in 
every detail with the accompanying product. There may be small 
discrepancies in the values of components for the purposes of 
pulse shape, timing, offset, etc., and, occasionally, minor logic 
changes. Where any such inconsistencies exist, please be assured 
that the unit is correct and incorporates the most up-to-date cir- 
cuitry. In a similar way the firmware may undergo revision when 
the instrument is serviced. Should this be the case, manual up- 
dates will be made available as necessary. 

Products requiring maintenance should be returned to the Cus- 
tomer Service Department or authorized service facility. LeCroy 
will repair or replace any product under warranty at no charge. 
The purchaser is only responsible for the transportation charges 
arising from return of the goods to the service facility. 

For all LeCroy products in need of repair after the warranty pe- 
riod, the customer must provide a Purchase Order Number before 
any equipment which does not operate correctly can be repaired 
or replaced. The customer will be billed for the parts and labor for 
the repair, as well as for shipping. 

To determine your nearest authorized service facility, contact the 
Customer Service Department or your field office. All products 
returned for repair should be identified by the model and serial 
numbers and include a description of the defect or failure, name 
and phone number of the user, and, in the case of products re- 
turned to the factory, a Return Authorization Number (RAN). 
The RAN may be obtained by contacting the Customer Service 
Department in New York, tel. (914)578-6097, in Geneva, tel. 
(41)22/719 21 11, or your nearest sales office. 

Return shipments should be made prepaid. LeCroy will not accept 
C.O.D. or Collect Return Shipments. Air- freight is generally rec- 
ommended. Wherever possible, the original shipping carton 
should be used. If a substitute carton is used, it should be rigid and 
be packed such that the product is surrounded with a minimum of 
four inches of excelsior or similar shock-absorbing material. In 
addressing the shipment, it is important that the Return Authoriza- 
tion Number be displayed on the outside of the container to ensure 
its prompt routing to the proper department within LeCroy. 
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ABOUT REMOTE CONTROL 



Two modes of operation are available in the oscilloscope. The in- 
strument may be operated either manually, by using the 
front-panel controls, or remotely by means of an external control- 
ler (which is usually a computer, but may be a simple terminal) . 
This Remote Control Manual describes how to control the oscillo- 
scope in the remote mode. For explanations on how to manually 
set front-panel controls, refer to the Operator’s Manual. 

The oscilloscope is remotely controlled via either the GPIB (Gen- 
eral Purpose Interface Bus) or the RS-232-C communication 
ports. Whenever the rear-panel GPIB address switches are set be- 
tween 0 and 30, control is via GPIB; when they are at 31 or above, 
control is via RS-232--C. The instrument can be fully controlled in 
remote mode. The only actions which cannot be performed re- 
motely are switching on the instrument or setting the remote 
address. 

This section introduces the basic remote control concepts which 
are common to both RS-232-C and GPIB. It also presents a brief 
description of remote control messages. 

Sections 3 and 4 explain how to send program messages over the 
GPIB or the RS-232-C interfaces, respectively. Section 5 alpha- 
betically lists all the remote control commands. Section 6 is a 
detailed description and tutorial of the transfer and format of 
waveforms, whereas Section 7 explains the use of status bytes for 
error reporting. Appendix A shows some complete programming 
examples. Appendix B contains a printout of a waveform tem- 
plate. 



GPIB IMPLEMENTATION 

STANDARD The remote commands conform to the GPIB IEEE 488.2 stan- 

dard 1 . This new standard may be seen as an extension of the 
IEEE 488.1 standard which dealt mainly with electrical and me- 
chanical issues. The IEEE 488.2 recommendations have also 
been adopted for RS-232-C communications whenever applica- 
ble. 

PROGRAM MESSAGES To remotely control the oscilloscope the controller must send pro- 
gram messages which conform to precise format structures. The 
instrument will execute all program messages which are in the cor- 
rect form and ignore those where errors are detected. 



1. ANSI/IEEE Std. 488.2-1987, “IEEE Standard Codes, Formats, Protocols, and Common Commands”, The 
Institute of Electrical and Electronics Engineers Inc., 345 East 47th Street, New York, NY 10017, USA. 
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2 * About Remote Control 



COMMANDS 
AND QUERIES 



Warning or error messages are normally not reported by the instru- 
ment, unless the controller explicitly examines the relevant status 
register, or if the status enable registers have been set in such a way 
that the controller can be interrupted when an error occurs. The 
status registers are explained in Section 7. 

During the development of the control program it is possible to 
observe all remote control transactions, including error messages, 
on an external monitor connected to the RS-232-C port. Refer to 
the command “COMM HELP” for further details. 



Program messages consist of one or several commands or queries. 
A command directs the instrument to change its state, e.g. to 
change its time base or vertical sensitivity. A query asks the instru- 
ment about its state. Very often, the same mnemonic is used for a 
command and a query, the query being identified by a <?> after 
the last character. 

For example, to change the time base to 2 msec/div, the controller 
should send the following command to the instrument 

TIMEDIV 2 MS 

To ask the instrument about its time base, this query should be 
sent 

TIME_DIV? 

A query causes the instrument to send a response message. The 
control program should read this message with a “read” instruc- 
tion to the GPIB or RS-232-C interface of the controller. The 
response message to the query above might be 

TIME DIV 10 NS 

The portion of the query preceding the question mark is repeated 
as part of the response message. If desired, this text may be sup- 
pressed with the command “COMM_HEADER” . 

Depending on the state of the instrument and the computation to 
be done, the controller may have to wait up to several seconds for 
a response. Command interpretation does not have priority over 
other oscilloscope activities. It is therefore judicious to set the con- 
troller IO timeout conditions to 3 or more seconds. In addition, it 
must be remembered that an incorrect query message will not gen- 
erate a response message. 
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LOCAL AND REMOTE 
STATE 



PROGRAM MESSAGE 
FORM 



About Remote Control 
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As a rule, remote commands are only executed by the instrument 
when it is in the REMOTE state, whereas queries are always ex- 
ecuted. A few commands which don’t affect the state of the front 
panel are also executed in LOCAL (refer to the beginning of Sec- 
tion 5 for a list of these commands) . When the instrument is in 
REMOTE, all front-panel controls are disabled, except the left- 
hand menu buttons, the intensity controls (which can be disabled 
with the command “INTENSITY”) and the LOCAL button 
(which can be disabled by setting the instrument to LOCAL 
LOCKOUT). For an explanation on how to set the instrument to 
LOCAL, REMOTE or LOCAL LOCKOUT, refer to Section 3 for 
GPIB and to Section 4 for RS-232-C. 



An instrument is remotely controlled with program messages 
which consist of one or several commands or queries, separated by 
semicolons <;> and ended by a terminator: 

<command/query>; ;<command/query> <terminator> 

Upper and/or lower case characters can be used for program mes- 
sages. 

The instrument does not decode an incoming program message 
before a terminator has been received (exception: if the program 
message is longer than the 256 byte input buffer of the instrument, 
the oscilloscope starts analyzing the message when the buffer is 
full) . The commands or queries are executed in the order in which 
they are transmitted. 

In GPIB mode, the following are valid terminators: 

<NL> New-line character (i.e. the ASCII new-line 

character, whose decimal value is 10). 

<NL> <EOI> New-line character with a simultaneous <EOI> 
signal. 

<EOI> <EOI> signal together with the last character of 

the program message. 

Note: The <EOI> signal is a dedicated GPIB interface line which 
can be set with a special call to the GPIB interface driver. Refer to 
the GPIB interface manufacturer’s manual and support pro- 
grams. 

The <NL> <EOI> terminator is always used in response messages 
sent by the instrument to the controller. 

In RS-232-C, the terminator may be defined by the user with the 
command “COMM_RS232” . The default value is <CR>, i.e. the 
ASCII carriage return character, the decimal value of which is 13. 
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About Remote Control 



Examples 



COMMAND/QUERY 

FORM 



Example 



Header 



GRID DUAL This program message consists of a 

single command which instructs the 
instrument to display a dual grid. 
The terminator is not shown since it 
is usually automatically added by 
the interface driver routine which 
writes to the GPIB (or RS-232). 

BWL ON; DISPLAY OFF; DATE? 

This program message consists of 
two commands, followed by a 
query. They instruct the instrument 
to turn on the bandwidth limit, turn 
off the display, and then ask for the 
current date. Again, the terminator 
is not shown. 



The general form of a command or a query consists of a command 
header <header> which is optionally followed by one or several 
parameters <data> separated by commas: 

<header>[?] <data>,...,<data> 

The notation [?] shows that the question mark is optional (turning 
the command into a query) . The detailed listing of all commands 
in Section 5 indicates which commands may also be queries. 
There is a space between the header and the first parameter. 
There are commas between parameters. 

DATE 15, OCT, 1989, 13,21, 16 

This command instructs the oscillo- 
scope to set its date and time to 15 
OCT 1989, 13:21:16. The com- 
mand header “DATE” indicates 
the action, the 6 data values specify 
it in detail. 

The header is the mnemonic form of the operation to be per- 
formed by the oscilloscope. All command mnemonics are listed in 
alphabetic order in Section 5. 

The majority of the command/query headers have a long form for 
optimum legibility and a short form for better transfer and decod- 
ing speed. The two forms are fully equivalent and can be used 
interchangeably. For example, the following two commands for 
switching to the automatic trigger mode are fully equivalent: 

TRIG MODE AUTO and TRMD AUTO 
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About Remote Control 



Header path 



Example 



Data 



Some command/query mnemonics are imposed by the IEEE 
488.2 standard. They are standardized so that different instru- 
ments present the same programming interface for similar 
functions. All these mnemonics begin with an asterisk <*>, e.g. 
the command “*RST” is the IEEE 488.2 imposed mnemonic for 
resetting the instrument, whereas “*TST?” instructs the instru- 
ment to perform an internal self-test and to report the outcome. 



Some commands or queries apply to a sub-section of the oscillo- 
scope, e.g. a single input channel or a trace on the display. In such 
cases, the header must be preceded by a path name that indicates 
the channel or trace to which the command applies. The header 
path normally consists of a 2-letter path name followed by a colon 
<:> which immediately precedes the command header. 

Usually one of the waveform traces can be specified in the header 
path (refer to the individual commands listed in Section 5 for de- 
tails on which values apply to a given command header): 



Cl, C2 
C3, C4 
MC, MD 
FE, FF 
EA, EB 
EX, EX10 



Channels 1 and 2 

Channels 3 and 4 (in 4-channel instruments) 

Memory C and D 

Function E and F 

Expand A and B 

External trigger 



Cl:OFST -300 MV Set the offset of Channel 1 to 

-300 mV 

Header paths need only be specified once. Subsequent commands 
whose header destination is not indicated are assumed to refer to 
the last defined path. For example, the following commands are 
identical: 



C2:VDIV?; C2:OFST? What is the vertical sensitivity and 

the offset of channel 2? 

C2:VDIV?; OFST? Same as above, without repeating 

the path. 

Whenever a command/query uses additional data values, they are 
expressed in terms of ASCII characters. There is a single excep- 
tion: the transfer of waveforms with the command/query 
“WAVEFORM”, where the waveform may be expressed as a se- 
quence of binary data values. Refer to Section 6 for a detailed 
explanation of the format of waveforms. 

ASCII data can have the form of character, numeric, string or 
block data. 
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^ About Remote Control 



Character data 



Numeric Data 



These are simple words or abbreviations for the indication of a 
specific action. 

BAND WIDTH JLIMIT ON The data value “ON” indicates that 

the bandwidth limit should be 
turned on, rather than off. 

In some commands, where as many as a dozen different parame- 
ters can be specified, or where not all parameters apply at the same 
time, the format requires pairs of data values. The first one names 
the parameter to be modified and the second gives its value. Only 
those parameter pairs to be changed need to be indicated. 

HARDCOPYSETUP DEV, HP7470A, PORT, GPIB,PSIZE,A4 

Three pairs of parameters are spe- 
cified. The first specifies the device 
as the H7470A plotter (or compat- 
ible), the second indicates the 
GPIB port and the third requests 
the A4 format for paper size. While 
the command “ HARDCOPY_SET- 
UP” allows many more parameters, 
they are either not relevant for plot- 
ters or they are left unchanged. 

The numeric data type is used to enter quantitative information. 
Numbers can be entered as integers, as fractions or in exponential 
representation. 

EA;VPOS -5 Move the displayed trace of Expand A down- 
wards by 5 divisions. 

C2:OFST 3.56 Set the DC offset of Channel 2 to 3.56 V. 

TDIV 5.0E-6 Adjust the time base to 5 jisec/div. 

Note: Numeric values may be followed by multipliers and units, 
modifying the value of the numerical expression. The following 
mnemonics are recognized: 
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About Remote Control 



String Data 



Block Data 



RESPONSE 

FORM 



EX 


1E18 


Exa- 


PE 


1E15 


Peta- 


T 


1E12 


Tera- 


G 


1E9 


Giga- 


MA 


1E6 


Mega- 


K 


1E3 


kilo- 


M 


IE-3 


milli- 


U 


IE-6 


micro- 


N 


IE-9 


nano- 


PI 


IE-12 


pico- 


F 


IE-15 


femto- 


A 


IE-18 


atto- 



For example, there are many ways of setting the time base of the 
instrument to 5 psec/div: 

TDIV 5E-6 
TDIV 5 US 



TDIV 5000 NS 
TDIV 5000E-3 US 

This data type enables the transfer of a (long) string of characters 
as a single parameter. String data are formed by simply enclosing 
any sequence of ASCII characters between simple quotes. 

MESSAGE ‘Connect probe to point J3’ 

The instrument displays this message in the Message field above 
the grid. 

These are binary data values coded in hexadecimal ASCII, i.e. 
4-bit nibbles are translated into the digits 0,...9, A,...F and trans- 
mitted as ASCII characters. They are only used for the transfer of 
waveforms (command “WAVEFORM”) and of the instrument 
configuration (command “PANEL_SETUP”) 



Exponential notation, without any 
suffix. 

Suffix multiplier “U” for IE-6, 
with the (optional) suffix “S” for 
seconds. 



MESSAGE 

The instrument sends a response message to the controller, as an 
answer to a query. The format of such messages is the same as that 
of program messages, i.e. individual responses in the format of 
commands, separated by semicolons <;> and ended by a termina- 
tor. They can be sent back to the instrument in the form in which 
they are received, and will be accepted as valid commands. In 
GPIB response messages, the <NL> <EOI> terminator is always 
used. 

For example, if the controller sends the program message: 

TIME DIV? ;TRIG_MODE NORM;Cl :COUPLING? (terminator 
not shown) 
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the instrument might respond as follows: 

TIMEDIV 50 NS ;C1 COUPLING D50 (terminator not shown) 

The response message only refers to the queries, i.e. 
“TRIG_MODE” is left out. If this response is sent back to the 
instrument, it is a valid program message for setting its time base to 
50 nsec/div and the input coupling of Channel 1 to 50 Q. 

Whenever a response is expected from the instrument, the control 
program must instruct the GPIB or RS-232-C interface to read 
from the instrument. If the controller sends another program mes- 
sage without reading the response to the previous one, the 
response message in the output buffer of the instrument is dis- 
carded. 

The instrument uses somewhat stricter rules for response messages 
than for the acceptance of program messages. Whereas the con- 
troller may send program messages in upper or lower case 
characters, response messages are always returned in upper case. 
Program messages may contain extraneous spaces or tabs (white 
space), response messages do not. Whereas program messages 
may contain a mixture of short and long command/query headers, 
response messages always use short headers as a default. However, 
the instrument can be forced with the command 
“COMMJHEADER” to use long headers or no headers at all. If 
the response header is omitted, the response transfer time is mini- 
mized, but such a response could not be sent back to the 
instrument again. In this case suffix units are also suppressed in the 
response. 

If the trigger slope of Channel 1 is set to negative, the query 
“C1:TRSL?” could yield the following responses: 

Cl:TRIG_SLOPE NEG header format: long 

C1:TRSL NEG header format: short 

NEG header format: off 

Waveforms which are obtained from the instrument using the 
query “WAVEFORM?” constitute a special kind of response mes- 
sage. Their exact format can be controlled with the commands 
“ COMM_FORMAT” and “COMM_ORDER”, as explained in 
Section 6. 
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GPIB OPERATION 



GPIB STRUCTURE 



INTERFACE 

CAPABILITIES 



This section describes how to remotely control the oscilloscope via 
the GPIB. Topics discussed include interface capabilities, address- 
ing, standard bus commands, and polling schemes. 



The GPIB is like an ordinary computer bus, except that it inter- 
connects independent devices via a cable bus whereas a computer 
has its circuit cards interconnected via a backplane bus. The GPIB 
carries program messages and interface messages: 

• Program messages, often called device-dependent messages, 
contain programming instructions, measurement results, in- 
strument status and waveform data. Their general form is 
described in Section 2. 

• Interface messages manage the bus itself. They perform func- 
tions such as initializing the bus, addressing and unaddressing 
devices and setting remote and local modes. 

Devices on the GPIB can be listeners, talkers, and/or controllers. 
A talker sends program messages to one or more listeners. A con- 
troller manages the flow of information on the bus by sending 
interface messages to the devices. 

The oscilloscope can be a talker or a listener, but not a controller. 
The host computer, however, must be able to act as a listener, 
talker and controller. For details on how the controller configures 
the GPIB for specific functions, refer to the GPIB interface man- 
ufacturer’s manual. 



The interface capabilities of the oscilloscope include the following 
IEEE 488.1 definitions: 

AH1 Complete Acceptor Handshake 

SHI Complete Source Handshake 

L4 Partial Listener Function 

T5 Complete Talker Function 

SRI Complete Service Request Function 

RL1 Complete Remote/Local Function 

DC1 Complete Device Clear Function 

DTI Complete Device Trigger 

PP1 Parallel Polling: remote configurability 

CO No Controller Functions 

E2 Tri-state Drivers 
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^ GPIB Operation 



ADDRESSING 



GPIB SIGNALS 



Data Lines 



Handshake Lines 



Interface Management Lines 



Every device on the GPIB has an address. When the thumbwheel 
address switches on the rear panel of the oscilloscope are set to a 
value between 0 and 30, the instrument can be controlled via 
GPIB. When the switches are set to above 30, the instrument can 
execute talk-only operations on the GPIB, for example driving a 
GPIB plotter. In this case no controller is present and the instru- 
ment is directly connected to the plotter. Addresses above 30 also 
enable the instrument to be controlled via the RS-232-C port. 

The instrument reads the address switches once at power on, or 
when the RESET button on the rear panel is pressed. If the ad- 
dress is changed during operation, the instrument must be 
powered again to enable the new address. The value of the GPIB 
address appears in the menu “Auxiliary Setups”. 

If the oscilloscope is addressed to talk, it will remain configured to 
talk until a universal untalk command (UNT) , its own listen ad- 
dress (MLA), or another instrument’s talk address is received. 

Similarly, if the oscilloscope is addressed to listen, it will remain 
configured to listen until a universal unlisten command (UNL), or 
its own talker address (MTA) is received. 

The bus system consists of 16 signal lines and 8 ground or shield 
lines. The signal lines are divided into 3 groups: 

• 8 data lines 

• 3 handshake lines 

• 5 interface management lines 

The eight data lines, usually called DI01 through DI08, carry both 
program and interface messages. Most of the messages use the 
7-bit ASCII code, in which case DI08 is unused. 

These three lines control the transfer of message bytes between 
devices. The process is called a three-wire interlocked handshake 
and it guarantees that the message bytes on the data lines are sent 
and received without transmission error. 

The following five lines manage the flow of information across the 
interface. 

ATN (ATteNtion): The controller drives the ATN line true when 
it uses the data lines to send interface messages such as talk and 
listen addresses or a device clear (DCL) message. When ATN is 
false, the bus is in the data mode for the transfer of program mes- 
sages from talkers to listeners. 

IFC (InterFace Clear): The controller sets the IFC line true to 
initialize the bus. 
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GPIB Operation 3 



I/O Buffers 



IEEE 488.1 
STANDARD 



REN (Remote ENable): The controller uses this line to place de- 
vices in remote or local program mode. 

SRQ (Service ReQuest): Any device can drive the SRQ line true 
to asynchronously request service from the controller. This is the 
equivalent of a single interrupt line on a computer bus. 

EOI (End Or Identify): This line has two purposes. The talker 
uses it to mark the end of a message string. The controller uses it to 
tell devices to identify their response in a parallel poll (discussed 
later in this section). 

The instrument has a 256-byte input buffer and a 256-byte output 
buffer. An incoming program message is not decoded before a 
message terminator has been received. However, if the input buff- 
er becomes full (because the program message is longer than the 
buffer), the instrument starts analyzing the message. In this case 
data transmission is temporarily halted, and the controller may 
generate a timeout if the limit was set too low. 



MESSAGES The IEEE 488.1 standard specifies not only the mechanical and 
electrical aspects of the GPIB, but also the low-level transfer pro- 
tocol, e.g. it defines how a controller addresses devices, turns 
them into talkers or listeners, resets them or puts them in the re- 
mote state. Such interface messages are executed with the 
interface management lines of the GPIB, usually with ATN true. 

All of these messages (except GET) are executed immediately 
upon reception and not in chronological order with normal com- 
mands. 

Note : In addition to the IEEE 448.1 interface message standards, 
the new IEEE 488.2 standard specifies some standardized pro- 
gram messages, i.e. command headers. They are identified with a 
leading asterisk <*> and are listed among the commands in Sec- 
tion 5. 

The command list in Section 5 does not contain any command for 
clearing the input/output buffers or for setting the instrument to 
the remote state. This is because such commands are already spe- 
cified as IEEE 488.1 standard messages. Refer to the GPIB 
interface manual of the host controller as well as to its support 
programs which should contain special calls for the execution of 
these messages. 

The following describes those IEEE 488.1 standard messages 
which go beyond mere reconfiguration of the bus and which have 
an effect on the operation of the instrument. 



13 




^ GPIB Operation 



Device Clear 



Group Execute Trigger 



Remote ENable 



Local LOckout 



Go To Local 



In response to a universal Device CLear (DCL) or a Selected De- 
vice Clear message (SDC), the oscilloscope clears the input/output 
buffers, aborts the interpretation of the current command (if any) 
and clears any pending commands. Status registers and status en- 
able registers are not cleared. Although DCL has an immediate 
effect it can take several seconds to execute this command if the 
instrument is busy. 

The Group Execute Trigger message (GET) causes the oscillo- 
scope to arm the trigger system. It is functionally identical to the 
“ *TRG” command. 

This interface message is executed when the controller holds the 
Remote ENable control line (REN) true and configures the instru- 
ment as a listener. The REMOTE LED on the front panel lights up 
to indicate that the instrument is set to the remote mode. All the 
front-panel controls are disabled except the left-hand menu but- 
tons, the intensity controls and the LOCAL button. The menu 
indications on the left-hand side of the screen no longer appear 
since menus cannot now be operated manually. Whenever the 
controller returns the REN line to false, all instruments on the bus 
return to LOCAL. Individual instruments can be returned to LO- 
CAL with the Go To Local message (see below). 

As a rule, remote commands are only executed when the instru- 
ment is in the remote state, whereas queries are always executed. 
Local front-panel control may be regained by pressing the LO- 
CAL push button, unless the instrument was placed in the Local 
LOckout (LLO) mode. 

The Local LOckout command (LLO) causes the LOCAL button 
on the front panel of the oscilloscope to be disabled. The LLO 
command can be sent in local or remote mode but only becomes 
effective once the instrument has been set to the remote mode. 

The Go To Local message (GTL) causes the instrument to return 
to the local mode. All front-panel controls become active and the 
menus on the left-hand side of the screen reappear. Thereafter, 
whenever the instrument is addressed as a listener it will be imme- 
diately set to the remote state again. 

Note that a GTL message does not clear the local lockout if it was 
set. Thus, whenever the instrument returns to the remote state the 
local lockout mode would immediately be effective again. 

A command string should not be immediately followed by a GTL 
message. Since GTL is executed at once, the instrument may al- 
ready be returned to the local state before the commands in the 
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XnterFace Clear 



PROGRAMMING 
GPIB TRANSFERS 



Configuring the 
GPIB Hardware 



input buffer are interpreted. Therefore, the instrument may refuse 
to execute them if they require the instrument to be in REMOTE. 
A safe way to ensure that all commands have been interpreted is to 
append a query (e.g. “ *STB?”) to the command string and to wait 
for the response before sending a GTL. 

The InterFace Clear message (IFC) initializes the GPIB but has no 
effect on the operation of the oscilloscope. 



To illustrate the GPIB programming concepts a number of exam- 
ples written in BASICA are included in this section. It is assumed 
that the controller is IBM-PC compatible, running under DOS, 
and that it is equipped with a National Instruments 2 GPIB inter- 
face card. GPIB programming with other languages such as C or 
Pascal is quite similar. 

If you use another computer or another GPIB interface, refer to 
the interface manual for installation procedures and subroutine 
calls similar to those described here. 



Check that the GPIB interface is properly installed in the comput- 
er. If it is not, follow the installation instructions of the interface 
manufacturer. In the case of the National Instruments interface, it 
is possible to modify the base I/O address of the board, the DMA 
channel number and the interrupt line setting using switches and 
jumpers. In our program examples, they are assumed to be left in 
their default positions. 

Connect the oscilloscope to the computer with a GPIB interface 
cable. Set the GPIB address on the rear of the instrument to the 
required value. The program examples assume that it is set to 4. 
Remember to power the instrument up after setting the GPIB ad- 
dress. 



Configuring the 

GPIB Driver Software The host computer needs an interface driver which handles the 

transactions between the user’s programs and the interface board. 
In the case of the National Instruments interface, the installation 
procedure: 

» copies the GPIB handler GPIB.COM into the boot directory. 

• modifies the DOS system configuration file CONFIG.SYS to 
declare the presence of the GPIB handler. 

2. National Instruments Corporation, 12109 Technology Boulevard, Austin, Texas 78727 
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• creates a sub-directory GPIB-PC. 

• installs in GPIB-PC a number of files and programs which are 
useful for testing and reconfiguring the system, and for writing 
user programs. 

The following files in the sub-directory GPIB-PC are of particular 
use: 

IBIC.EXE allows interactive control of the GPIB via functions en- 
tered at the keyboard. Use of this program is highly recommended 
to anyone who is not familiar with GPIB programming or with the 
oscilloscope’s remote commands. An example of the use of 
IBIC.EXE is shown in Appendix A. 

DECL.BAS is a declaration file that contains code to be included 
at the beginning of any BASICA application program. Simple 
application programs can be quickly written by appending the 
user’s instructions to DECL.BAS and executing the complete file. 

IBCONF.EXE is an interactive program which allows inspection 
or modification of the current settings of the GPIB handler. To run 
IBCONF.EXE, refer to the National Instruments user’s manual. 

In the program examples in this section, it is assumed that the 
National Instruments GPIB driver GPIB.COM is in its default 
state, i.e. that the user has not modified it with IBCONF.EXE. 
This means that the interface board can be referred to by the sym- 
bolic name ’GPIBO’ and that devices on the GPIB bus with 
addresses between 1 and 16 can be called by the symbolic names 
’DEVI’ to ’DEV16’. 

Note: If you have a National Instruments PC2 interface card rath- 
er than PC2A, you must run IBCONF to declare the presence of 
this card rather than the default PC2A. 

Simple Transfers For a large number of remote control operations it is sufficient to 

use just 3 different subroutines (IBFIND, IBRD and IBWRT) pro- 
vided by National Instruments. The following complete program 
reads the time-base setting of the oscilloscope and displays it on 



the terminal: 
1-99 


<DECL.BAS> 


100 


DEV$=”DEV4” 


110 


CALL IBFIND (DEV$,SCOPE%) 


120 


CMD$=”TDIV?” 


130 


CALL IBWRT (SCOPE%, CMD$) 


140 


CALL IBRD(SCQPE%,RD$) 


150 


PRINT RD$ 


160 


END 
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Explanation Lines 1-99 are a copy of the file DECL.BAS supplied by National 

Instruments. The first 6 lines are required for the initialization of 
the GPIB handler. The other lines are declarations which may be 
useful for larger programs, but are not really required code. The 
sample program above only uses the strings CMD$ and RD$ which 
are declared in DECL.BAS as arrays of 255 characters. 

Note: DECL.BAS requires access to the file BIB.M during the 
GPIB initialization. BIB.M is one of the files supplied by National 
Instruments, and it must exist in the directory currently in use. 

Note: The first 2 lines of DECL.BAS each contain a string 
“XX XXX" which must be replaced by the number of bytes which 
determine the maximum workspace for BASICA (computed by 
subtracting the size of BIB.M from the space currently available in 
BASICA). For example, if the size of BIB.M is 1200 bytes and 
when BASICA is loaded it reports “60200 bytes free", you should 
replace “XXX XX" by the value 59000 or less. 

Lines 100 and 110 open the device “DEV4” and associate with it 
the descriptor “SCOPE%”. All I/O calls from now on will refer to 
“SCOPE%” . The default configuration of the GPIB handler recog- 
nizes “DEV4” and associates with it a device with GPIB address 4. 
If you want to use another GPIB address between 1 and 16, use 
the string “DEVx” with x = 1...16. If you want to use another 
name, run IBCONF.EXE to declare this name to the handler. 

Lines 120 and 130 prepare the command string TDIV? and trans- 
fer it to the instrument. The command instructs it to respond with 
the current setting of the time base. 

Line 140 reads the response of the instrument and places it into 
the character string RD$. 

Line 150 displays the response on the terminal. 

When running this sample program, the oscilloscope will automati- 
cally be set to the remote state when IBWRT is executed, and will 
remain in that state. Pressing the LOCAL button on the front pan- 
el will return the oscilloscope to local mode if the GPIB handler 
was modified to inhibit Local LOckout (LLO). 

Here is a slightly modified version of the sample program which 
checks if any error occurred during GPIB operation: 
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Some Additional 
Driver Calls 



1-99 <DECL.BAS> 

100 DEV$=”DEV4” 

110 CALL IBFIND(DEV$,SCOPE%) 

120 CMD$=”TDIV?” 

130 CALL IBWRT(SCOPE%,CMD$) 

140 IF ISTA% < 0 THEN GOTO 200 

150 CALL IBRD(SCOPE%,RD$) 

160 IF ISTA% < 0 THEN GOTO 250 

170 PRINT RD$ 

180 IBLOC (SCOPE%) 

190 END 

200 PRINT “WRITE ERROR = ”;IBERR% 

210 END 

250 PRINT “READ ERROR = ”;IBERR% 

260 END 

The GPIB status word ISTA%, the GPIB error variable IBERR% 
and the count variable IBCNT% are defined by the GPIB handler 
and are updated with every GPIB function call. Refer to the Na- 
tional Instruments user’s manual for details. The sample program 
above would report if the GPIB address of the instrument was set 
to a value other then 4. Line 180 resets the instrument to local with 
a call to the GPIB routine IBLOC. 

Example 2 in Appendix A provides a more useful program which 
enables interactive setting and inspection of the front-panel con- 
trols as well as archiving and recalling of waveforms. Note that this 
program is written with just 7 different GPIB calls. 



IBLOC is used to execute the IEEE 488.1 standard message Go 
To Local (GTL), i.e. it returns the instrument to the local state. 
The programming example above shows its use. 

IBCLR executes the IEEE 488.1 standard message Selected De- 
vice Clear (SDC). 

IBRDF and IBWRTF allow data to be read from GPIB to a file 
and data to be written from a file to GPIB respectively. Transfer- 
ring data directly to or from a storage device does not limit the size 
of the data block, but it may be slower than transferring to the 
computer memory. Example 2 in Appendix A shows the use of 
these calls. 

IBRDI and IBWRTI allow data to be read from GPIB to an inte- 
ger array and data to be written from an integer array to GPIB. 
Since the integer array allows storage of up to 64 kilobytes (in BA- 
SIC), IBRDI and IBWRTI should be used for the transfer of large 
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data blocks to the computer memory, rather than IBRD or IBWRT 
which are limited to 256 bytes by the BASIC string length. Note 
that IBRDI and IBWRTI only exist for BASIC, since the function 
calls IBRD and IBWRT for more modern programming languages, 
such as C, are much less limited in the data block size. 

IBTMO can be used to change the time-out value during program 
execution. The default value of the GPIB driver is 10 seconds, e.g. 
if the instrument does not respond to a IBRD call, IBRD will return 
with an error after the specified time. 

IBTRG executes the IEEE 48S.1 standard message Group Ex- 
ecute Trigger (GET), which causes the oscilloscope to arm the 
trigger system. 

National Instruments supply a number of additional function calls. 
In particular, it is possible to use the so-called board level calls 
which allow a very detailed control of the GPIB. The use of such 
calls is shown in Example 3 of Appendix A. 



PROGRAMMING 

SERVICE REQUESTS When an oscilloscope is used in a remote application, events often 

occur asynchronously, i.e. at times that are unpredictable for the 
host computer. The most common case is waiting for a trigger after 
the instrument has been armed. The controller must wait until the 
acquisition is finished before it can read the acquired waveform. 
The simplest way of checking if a certain event has occurred is by 
continuously or periodically reading the status bit associated with it 
until the required transition is detected. Continuous status bit poll- 
ing is described in more detail in the sub-section “Instrument 
Polls” . For a complete explanation of the status bytes refer to Sec- 
tion 7. 

A potentially more efficient way of detecting events occurring in 
the instrument is the use of the Service Request (SRQ) . This GPIB 
interrupt line can be used to interrupt program execution in the 
controller. Therefore, the controller can execute other programs 
while waiting for the instrument. Unfortunately, not all interface 
manufacturers support the programming of interrupt service rou- 
tines. In particular, National Instruments only supports the SRQ 
bit within the ISTA% status word. This requires the user to contin- 
uously or periodically check this word, either explicitly or with the 
function call IB WAIT. In the absence of real interrupt service rou- 
tines the use of SRQ may not be very advantageous. 

In the default state, after power-on, the Service ReQuest is dis- 
abled. The SRQ is enabled by setting the Service Request Enable 
register with the command “*SRE” and specifying which event 
should generate an SRQ. The oscilloscope will interrupt the con- 
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Example 1 



Example 2 



troller as soon as the selected event(s) occur by asserting the SRQ 
interface line. If several devices are connected to the GPIB, the 
controller may have to identify which instrument caused the inter- 
rupt by serial polling the various devices. 

Note: The SRQ bit is latched until the controller reads the STatus 
Byte Register (STB). The action of reading the STB with the com- 
mand “*STB?” clears the register contents except the MAV bit 
(bit 4) until a new event occurs. Service requesting may be dis- 
abled by clearing the SRE register (“*SRE 0”). 

To assert SRQ in response to the events “new signal acquired” 
or “ return-to-Iocal” (pressing the front-panel button LO- 
CAL). 

These events are tracked by the INR register which is reflected in 
the SRE register as the INB summary bit in position 0. Since the bit 
position 0 has the value 1, the command “*SRE 1” enables the 
generation of SRQ whenever the INB summary bit is set. 

In addition, the events of the INR register which may be summa- 
rized in the INB bit must be specified. The event “new signal 
acquired” corresponds to INE bit 0 (value 1) while the event “re- 
turn-to-local” is assigned to INE bit 2 (value 4) . The total sum is 
1+4=5. Thus the command “INE 5” is needed. 

CMD$=”INE 5;*SRE 1” 

CALL IBWRT(SCOPE%,CMD$) 

To assert SRQ when soft key 10 is pressed. 

The event “soft key 10 pressed” is tracked by the URR register. 
Since the URR register is not directly reflected in STB but only in 
the ESR register (URR, bit position 6), the ESE enable register 
must be set first with the command “ *ESE 64” to allow the URQ 
setting to be reported in STB. An SRQ request will now be gener- 
ated provided that the ESB summary bit (bit position 5) in the SRE 
enable register is set (“ *SRE 32”). 

CMD$=” *ESE 64;* SRE 32” 

CALL IBWRT(SCOPE%,CMD$) 
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INSTRUMENT POLLS 



Continuous Poll 



State transitions occurring within the instrument can be remotely 
monitored by polling selected internal status registers. This sub- 
section discusses a number of polling methods which may be used 
to detect the occurrence of a given event. 

1. Continuous poll 

2. Serial poll 

3. Parallel poll 

4. *1ST poll 

To emphasize the differences between these methods, the same 
example will be presented in each case, i.e. determining if a new 
acquisition has taken place. By far the simplest poll is the continu- 
ous poll. The other methods only make sense if interrupt service 
routines (servicing the SRQ line) are supported or if multiple de- 
vices on GPIB must be monitored simultaneously. 

In continuous polling a status register is continuously monitored 
until a transition is observed. This is the most straightforward 
method for detecting state changes but may be impracticable in 
some situations, especially in multiple device configurations. 

In the following example, the event “new signal acquired” is ob- 
served by continuously polling the INternal state change Register 
(INR) until the corresponding bit (in this case bit 0, i.e. value 1) is 
non-zero to indicate that a new waveform has been acquired. 
Reading INR clears it at the same time so that there is no need for 
an additional clearing action after a non-zero value has been de- 
tected. The command “CHDR OFF” instructs the instrument to 
omit any command headers when responding to a query. This sim- 
plifies the decoding of the response. The instrument would 
therefore send “1” rather than “INR 1”. 

CMD$=”CHDR OFF” 

CALL IBWRT(SCOPE%,CMD$) 

MASK% = 1 ’New Signal Bit has value 1 

LOOP% = 1 
WHILE LOOP% 

CMD$=”INR?” 

CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$) 

NEWSIG% = VAL(RD$) AND MASK% 

IF NEWSIG% = MASK% THEN LOOP% = 0 

WEND 
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Serial Poll 



Serial polling takes place once the SRQ interrupt line has been 
asserted. The controller examines which instrument has generated 
the interrupt by inspecting the SRQ bit in the STB register of each 
instrument. Because service request is based on an interrupt mech- 
anism, serial polling offers a reasonable compromise in terms of 
servicing speed in multiple device configurations. 

In the following example, the command “INE 1” enables the 
event “new signal acquired” to be reported in the INR to the INB 
bit of the status byte STB. The command “ *SRE 1” enables the 
INB of the status byte to generate an SRQ whenever it is set. The 
function call IBWAIT instructs the computer to wait until one of 
three conditions occur: &H8000 in the mask (MASK%) corre- 
sponds to a GPIB error, &H400Q to a time-out error and &H0800 
to the detection of RQS (ReQuest for Service generated by the 
SRQ bit). 

Whenever IBWAIT detects RQS it automatically performs a serial 
poll to find out which instrument generated the interrupt. It will 
only exit if there was a time-out or if the instrument “SCOPE%” 
generated SRQ. The additional function call IBRSP fetches the 
value of the status byte which may be further interpreted. For this 
example to function properly the value of ’Disable Auto Serial 
Polling’ must be set ’off’ in the GPIB handler (use IBCONF.EXE 
to check). 

CMD$=” *CLS; INE 1; *SRE 1” 

CALL IB WRT (SCOPE%,CMD$) 

MASK% = &HC800 

CALL IBWAIT(SCOPE%,MASK%) 

IF (IBSTA% AND &HC000) <> 0 THEN PRINT “GPIB or 
Time-out Error” : STOP 
CALL IBRSP (SCOPE%,SPR%) 

PRINT “Status Byte = ”, SPR% 

Note: After the serial poll is completed, the RQS bit in the STB 
status register is cleared . Note that the other STB register bits 
remain set until they are cleared by means of a “*CLS" command 
or the instrument is reset. If these bits are not cleared, they cannot 
generate another interrupt. 

Serial polling is only an advantage if there are several instruments 
that may need attention. Board-level function calls can deal simul- 
taneously with several instruments attached to the same interface 
board. Refer to the National Instruments user’s manual. 
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Parallel Poll Parallel polling is only an advantage if there are several instru- 

ments that may need attention. 

In parallel polling, the controller simultaneously reads the Individ- 
ual STatus bit (1ST) of all the instruments to determine which one 
needs service. Since parallel polling allows up to eight different 
instruments to be polled at the same time, parallel polling is the 
fastest way to identify state changes of instruments supporting this 
capability. 

When a parallel poll is initiated, each instrument returns a status 
bit via one of the DIO data lines. Devices may respond either indi- 
vidually using a separate DIO line or collectively on a single data 
line. Data line assignments are made by the controller via a Paral- 
lel Poll Configure (PPC) sequence. 

In the following example, the command “INE 1” enables the 
event “new signal acquired” in the INR to be reported to the INB 
bit of the status byte STB. The Pa Rallel poll Enable register (PRE) 
determines which events will be summarized in the 1ST status bit. 
The command “ *PRE 1” enables the INB bit to set the 1ST bit 
whenever it is set. Once parallel polling has been established, the 
parallel poll status is examined until a change on data bus line 
DI02 takes place. 

Stage 1: Enable the INE and PRE registers, configure the con- 
troller for parallel poll and instruct the oscilloscope to respond 
on data line 2 (DI02) 

CMD1 $=“?_©$” 

CALL IBCMD (BRD0%, CMD 1 $) 

CMD$=”INE 1C PRE 1” 

CALL IBWRT(BRDO%,CMD$) 
CMD4$=CHR$(&H5)+CHR$(&H69)+”?” 

CALL IBCMD (BRD0%,CMD4$) 
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♦1ST Poll 



Stage 2: Parallel poll the instrument until DI02 is set 

LOOP% = 1 
WHILE LOOP% 

CALL IBRPP(BRDO%,PPR%) 

IF (PPR% AND &H2) = 2 THEN LOOP% = 0 

WEND 

Stage 3: Disable parallel polling (hex 15) and clear the parallel 
poll register 

CMD5 $=CHR$ (&H 15) 

CALL IBCMD(BRD0%,CMD5$) 

CALL IBCMD(BRD0%,CMD1$) 

CMD$=” *PRE 0” 

CALL IB WRT (BRD0%,CMD$) 

Note 1: In the example above, board-level GPIB function calls 
are used. It is assumed that the controller (board) and oscillo- 
scope (device) are respectively located at addresses 0 and 4. The 
listener and talker addresses for the controller and oscilloscope 
are: 

Logic device Listener address Talker address 

controller 32 (ASCII<space>) 64 (ASCII®) 

oscilloscope 32+4=36 (ASCII $) 64+4=68 (ASCII D) 

Note 2: The characters “?” and appearing in the command 
strings stand for unlisten and untalk respectively. They are used to 
set the devices to a “known” state. 

Note 3: To shorten the size of the program examples, device talk- 
ing and listening initialization instructions have been grouped into 
character chains. They are: 

CMD1$ = “ ?_@$ ” ’Unlisten, Untalk, PC talker, DSO listener 

Note 4: The remote message code for executing a parallel response 
in binary form is 01101PPP where PPP specifies the data line. 
Since data line 2 is selected, the identification code is 001 which 
results in the code 01101001 (binary) or &H69 (hex). See Table 
38 of the IEEE 488-1978 Standard for further details. 

The state of the Individual STatus bit (1ST) returned in parallel 
polling can also be read by sending the “ *IST?” query. To enable 
this poll mode, the oscilloscope must be initialized as for parallel 
polling by writing into the PRE register. Since *IST polling emu- 
lates parallel polling, this method is applicable in all instances 
where parallel polling is not supported by the controller. 
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DRIVING A HARD-COPY 
DEVICE 



Plotting/Printing without 
a GPIB Controller 



In the following example, the command “INE 1” enables the 
event “new signal acquired” in the INR to be reported to the INB 
bit of the status byte STB. The command “*PRE 1” enables the 
INB bit to set the 1ST bit whenever it is set. The command “CHDR 
OFF” suppresses the command header in the response of the in- 
strument, simplifying the interpretation. The status of the 1ST bit is 
then continuously monitored until it is set by the instrument. 

CMD$=”CHDR OFF; INE 1; *PRE 1” 

CALL IBWRT(SCOPE%,CMD$) 

LOOP% = 1 
WHILE LOOP% 

CMD$=”*IST?” 

CALL IBWRT (SCGPE%,CMD$) 

CALL IBRD(SCOPE%,RD$) 

IF VAL(RD$) = 1 THEN LOOP% = 0 

WEND 



The oscilloscope can be interfaced to a wide range of plotters and 
printers and be instructed to directly plot or print the screen con- 
tents onto these devices. The devices supported by the unit are 
listed with the command “HARDCOPY SETUP” in Section 5. 

When the hard-copy device is connected to the GPIB two differ- 
ent configurations should be considered depending on whether or 
not a GPIB controller is available. 



When only the oscilloscope and the hard-copy device are con- 
nected to the GPIB, the oscilloscope must be configured as 
talker-only and the hard-copy device as listener-only to ensure 
proper data transfer. The oscilloscope can be configured as a 
talker-only by using the thumbwheel switch at the rear of the in- 
strument to select an address larger than 30. The hard-copy 
device manufacturer usually specifies an address which forces the 
instrument into the listening mode. 

• Select the oscilloscope’s address to be larger than 30. 

• Switch on the oscilloscope. 

® Configure the “Hardcopy” sub menu in the “Auxiliary Set- 
ups” menu specifying “GPIB” as hard copy port. 

• Put the hard-copy device in listener-only mode. 

• Press the screen dump button on the front panel of the in- 
strument. 
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Plotting/Printing with 
a GPIB Controller 



1. Data read by controller 
and sent to printer/plotter 



2. Oscilloscope sends data to 
controller and printer/plotter 



If a controller is connected to the GPIB, data transfers must be 
supervised by the controller. The oscilloscope must be set to an 
address between 0 and 30 which differs from the controller’s and 
the hard-copy device’s address. Different schemes can be used to 
transfer the screen contents: 

1 . The controller reads the data into internal memory and then 
sends them to the printer/plotter. This alternative can be 
done with simple high-level GPIB function calls. 

2. The oscilloscope sends data to both the controller and the 
printer/plotter. 

3. The controller goes into a standby state. The oscilloscope 
becomes a talker and sends data directly to the printer/plot- 
ter. 



The controller stores the full set of printer/plotter instructions and 
sends them afterwards to the graphics device. This method is the 
most straightforward way of transferring screen contents but it re- 
quires a large amount of buffer storage (110K for 4 traces). 

CMD$ = “SCDP” 

CALL IBWRT(SCOPE%,CMD$) 

FILE$=” PLOT. DAT” 

CALL IBRDF(SCOPE%, FILES) 

CALL IBWRTF(PLOTTER%, FILES) 



The oscilloscope puts the printer/plotter instructions on to the bus. 
The data is directly plotted out and saved in scratch memory in the 
controller. The contents of the scratch file can be deleted later on. 



Stage 1: Controller talker, oscilloscope listener. Issue the 
screen dump command 

CMD1$=”?_@$” : CALL IBCMD(BRD0%,CMD1$) 
CMD$=”SCDP” : CALL IBWRT(BRD0%,CMD$) 

Stage 2: Oscilloscope talker, controller and plotter listeners. 
Plot data while storing data in scratch file SCRATCH.DAT 

CMD2$=”?_ D%”: CALL IBCMD(BRD0%,CMD2$) 

FILE$=” SCRATCH. DAT”: CALL IBRDF(BRD0%, FILES) 
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3. Oscilloscope talks directly 
to plotter/printer 



The controller goes into stand-by and resumes GPIB operations 
once the data have been plotted, that is when an EOI is detected. 

Stage 1: Controller talker, oscilloscope listener. Issue the 
screen dump command 

CMD1$=”?_@$” : CALL IBCMD(BRD0%,CMD1$) 
CMD$=”SCDP”: CALL IBWRT(BRDO%,CMD$) 



Stage 2: Oscilloscope talker, plotter listener. Put controller in 
stand-by 

CMD2$=”?_D%”: CALL IBCMD(BRD0%,CMD2$) 

V%= 1 : CALL IBGTS(BRDO%,V%) 

Note 1: In schemes 2 and 3, board-level GPIB function calls are 
used. It is assumed that the controller (board), the oscilloscope 
and the plotter are respectively located at addresses 0, 4 and 5, 
The listener and talker addresses for the controller, oscilloscope 
and plotter are: 



Logic device Listener address 



Talker address 



controller 
oscilloscope 
hard-copy dev. 



32 (ASCII<space>) 
32+4=36 (ASCII $) 
32+5=37 (ASCII %) 



64 (ASCII @) 
64+4=68 (ASCII D) 
64+5=69 (ASCII E) 



Note 2: The characters “?” and appearing in the command 
strings stand for unlisten and untalk respectively. They are used to 
set the devices to a “known” state. 



Note 3: To shorten the size of the program examples, device talk- 
ing and listening initialization instructions have been grouped into 
character chains. They are: 

CMD1$ = ’Unlisten, Untalk, PC talker, DSO listener 

CMD2$ = “? D” ’Unlisten, Untalk, PC listener, DSO talker 
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RS-232-C OPERATION 



INTRODUCTION 



Notation 



Example 



RS-232-C 

PIN ASSIGNMENTS 



LeCroy oscilloscopes may be remotely controlled using a host, ei- 
ther a terminal or a computer, via the RS-232-C port. For this 
purpose the oscilloscope must be set at an address higher than 30 
using the thumbwheel switch at the rear of the instrument. 

All the commands described in Section 5 are supported but wave- 
form transfer is only possible in HEX mode. T'he default value 
for COMM FORMAT is set appropriately. The syntax of the re- 
sponse to WF? is identical to the GPIB case. 

In this section some special RS-232-C commands are defined ei- 
ther for configuring the oscilloscope, or simulating GPIB 488.1 
messages such as setting the oscilloscope into remote or local 
modes. 

Throughout this section, characters which cannot be printed in 
ASCII will be represented by their mnemonics. 

<LF> is the ASCII line feed character whose decimal value is 
10 

<BS> is the ASCII backspace character whose decimal value 
is 8 

CTRL_U means that the control key and the U key are pressed 
simultaneously. 



The remote RS-232-C pin assignments (indicated on the rear 
panel) are as follows: 



Pin # 



Description 



2 T X D 

3 R X D 

4 RTS 



5 CTS 



20 DTR 



Transmitted data (from the oscilloscope). 
Received data (to the oscilloscope). 

Request to send (from the oscilloscope). 

If the software Xon/Xoff handshake is se- 
lected it is always TRUE. 

Otherwise (hardware handshake) it is TRUE 
when the oscilloscope is able to receive char- 
acters and FALSE when the oscilloscope is 
unable to receive characters. 

Clear to send (to the oscilloscope). 

When true, the oscilloscope can transmit, 
when false, transmission stops. It is used for 
the oscilloscope output hardware handshake. 

Data terminal ready (from oscilloscope). 
Always TRUE. 
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RS-232-C 

CONFIGURATION 



Echo of Received Characters 
by the Oscilloscope 



Handshake Control 



1 GND Protective Ground. 

7 SIG GND Signal Ground. 



The RS-232-C port is configured in full duplex. This means that 
the two sides (i.e. the controller and the oscilloscope) can both 
send and receive messages at the same time. However, when the 
oscilloscope receives a new command, it stops outputting. 

Transmission of long messages to the oscilloscope should be done 
while the oscilloscope is in a triggered mode with no acquisition 
in progress. This is especially important when sending waveforms 
or front-panel setups into the oscilloscope. 

The behavior of the RS-232-C port may be set according to the 
user’s needs. For this purpose, in addition to the basic setup on 
the front-panel menu there are “immediate commands” as well 
as a special command “COMM_RS232”. Immediate commands 
consist of the ASCII ESCape character <ESC> (whose decimal 
value is 27), followed by another character. Such commands are 
interpreted as soon as the second character has been received. 

Note: The RS-232-C baud rate, parity, character length and 
number of stop bits are among the parameters that are saved or 
recalled by the front-panel “SAVE” or “RECALL” button, or by 
the remote commands “ *SAV ”, “*RCL” or “PANEL_SETUP 
When recalling, care must be taken to ensure that these parame- 
ters are set at the same value as the actual ones. Otherwise, the 
host may no longer be able to communicate with the oscilloscope 
and a manual reconfiguration would be necessary. 



The serial port may echo the received characters. Echo is useful if 
the oscilloscope is attached to a terminal. Echoing can be turned 
on or off by sending the two character sequence <ESC>] or 
<ESC>[ respectively. Echoing is on by default. 

Note: The host must not echo characters received from the oscillo- 
scope. 

When the oscilloscope input buffer becomes almost full, the in- 
strument sends a handshake signal to the host telling it to stop 
transmitting. When this buffer has enough room to receive more 
characters another handshake signal will be sent. The handshake 
signals are either the CTRL-S (or <XOFF>) and CTRL-Q 
(<XON>) characters or a signal level on the RTS line (pin 4) . This 
is selected by sending the two-character sequence <ESC>) for 
XON/XOFF handshake - this is the default - or <ESC>( for RTS 
handshake. 
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RS-232-C Operation 



Editing Features 



Message Terminators 



Examples 



The flow of characters coming from the oscilloscope may be con- 
trolled either by a signal level on the CTS line (pin 5) or by the 
<XON>/<XOFF> pair of characters. 

When the oscilloscope is directly connected to a terminal, the fol- 
lowing features will facilitate the correction of typing errors: 

<BS> or <DELETE> Delete the last character. 

CTRL _U Delete the last line. 

“Message terminators” are markers that indicate to the receiver 
that a message has been completed. 

On input to the oscilloscope, the Program Message Terminator 
is one character which can be selected by the user. A good choice 
would be a character that is never used for anything else. The 
character is chosen using the command COMM_RS232 and the 
keyword El. The default Program Message Terminator is the 
ASCII character <CR>, whose decimal value is 13. 

The oscilloscope appends a Response Message Terminator to the 
end of each of its responses. It is a string, like a computer prompt, 
chosen by the user. This string must not be empty. The default 
Response Message Terminator is “\n\r” which means 
<LFxCR>. 

(1) COMM_RS232 El, 3 

This command informs the oscilloscope that each message it 
receives will be terminated with the ASCII character <ETX> 
which corresponds to 3 in decimal. 

(2) COMMJRS232 EO,”\r\nEND\r\n” 

This command indicates to the oscilloscope that it must ap- 
pend the string “\r\nEND\r\n” to each response. 

After these settings, a host command will look like: 
TDIV?<ETX> 

The oscilloscope responds: 

TDIV 1, S 
END 

Note: Having sent a COMM_RS232 command, the host must wait 
for the oscilloscope to change its behavior before sending a com- 
mand in the new mode. A safe way to do this is to include a query 
on the line which contains the COMMJRS232 command and wait 
until the response is received. For example, 

COMMJRS232 El, 3; *STB? 
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SRQ Message 



Example 



Long Line Splitting 



Example 



Remarks 



Each time the Master Summary Status (MSS) bit of the STatus 
Byte (STB) is set, the SRQ message (a string of characters) is sent 
to the host to indicate that the oscilloscope requests service. The 
RS-232-C SRQ message has the same meaning as the GPIB SRQ 
message. If the string is empty, no message will be sent. This is the 
default setting. Note that no response message terminator is added 
at the end of the SRQ message. 

COMM_RS232 SRQ, ”\r\n\nSRQ\r\n\a” 

When the MSS bit is set, the oscilloscope will send 
a <CR> followed by 2 <LF>s 
SRQ 

a <CR> followed by 1 <LF> 
and the buzer will sound. 

Line splitting is a feature provided for hosts that cannot accept 
lines with more than a certain number of characters. The oscillo- 
scope may be configured to split responses into many lines. This 
feature is very useful for waveform or front-panel setup transfers 
although it is applicable to all response messages. Two parameters 
control this feature: 

Line Separator: Off messages will not be 

split into lines 

<CR>,<LF> or <CRxLF> possible line termi- 
nators. 

Line length: the maximum number of characters in a line. 

COMM_RS232 LS,LF,LL,40 

The line separator is the ASCII character <LF>, the line is a maxi- 
mum of 40 characters long (excluding the line separator) . 

If the oscilloscope receives the command PNSU?, it may answer: 

PNSU #9000001496 

AAAA5 5 5 500065 5 AA4030005 80019000000000001 
OOOOOOOOOOOOOOOOOOOOOOOOOOOCIBOIOO 58 OOOO 
0000000000000000000000000000000000000000 



Long commands sent to the oscilloscope may not be split into 
lines. If a command sent to the oscilloscope is the response to a 
previous query, the line split characters (<LF> and/or <CR>) must 
be removed. 
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COMMANDS SIMULATING 
GPIB COMMANDS 

<ESC>C or <ESC>c 
Device clear command. 



<ESC>R or <ESC>r 
Set to remote command 

nDpivr\ 



<ESC>L or <ESC>1 
Set to local command 



<ESC>F or <ESC>f 

Set local lockout command 



<ESC>T or <ESC>t 
Trigger command (GET) 



This also applies to line split characters inside strings sent to the 
oscilloscope. 

However, hex-ASCII data sent to the oscilloscope may contain 
line split characters. If you wish to use line splitting, ensure that 
neither the input message terminator characters nor the line split 
characters occur in the data. 



This command clears the input and output buffers. It has the same 
meaning as the GPIB DCL or SDC interface messages. 



This command puts the oscilloscope into the remote mode. Its 
function is the same as GPIB asserting the REN line and setting the 
oscilloscope to listener. 



This command puts the oscilloscope into local mode. It clears local 
lockout. It has the same function as GPIB setting the REN line to 
false. 



This command disables the front-panel “LOCAL” button either 
immediately if the oscilloscope is already in the remote mode or 
later when the oscilloscope is next set to remote control. This dis- 
abling of the front-panel “LOCAL” button is called “Local 
Lockout” and can only be cancelled with the <ESC>L command. 
<ESC>F has the same meaning as the GPIB LLO interface mes- 
sage. 



This command rearms the oscilloscope while it is in “SINGLE” or 
in “SEQUENCE” mode (valid only while the oscilloscope is in the 
remote mode). It has the same meaning as the “ *TRG” com- 
mand, and also the same meaning as the GPIB GET interface 
message. 
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SYSTEM COMMANDS 



ORGANIZATION 



COMMAND SUMMARY 
Acquisition 



Communication 



This section of the manual lists all commands and queries recog- 
nized by the oscilloscope. For easy reference the listings are 
arranged in alphabetical order. Each command starts on a new 
page and the name (header) of the command is given in both the 
long and short forms. Below each name (header) it is indicated 
whether it denotes a command only, a command as well as a 
query, or a query only. For those headers that may be used to 
command an action, for example to modify a setup parameter, or 
to obtain some information such as the current value of a setup 
parameter, the query form is derived by appending a question 
mark (?) immediately to the header without intervening spaces. 



The description of each command starts with a short explanation 
of the function performed by it, followed by a presentation of the 
formal syntax. In the formal syntax the header appears in mixed 
mode characters with the characters used to construct the short 
form shown in upper case. 



Where applicable, the syntax of the query form is given along with 



4-T vAnnAnf’fl fRa urtll 

uic 1O1 mat ui urc FcapOiioc mt uaAiiiULjtuj^v wm 






For most commands the description terminates with a short exam- 
ple illustrating a typical use of the command. The GPIB examples 
assume that the controller is equipped with a National Instruments 
interface board, and they show calls to the National Instruments 
interface subroutines in BASIC. The device name of the oscillo- 
scope has been defined as “SCOPE%”. 



The following is an overview of the commands grouped according 
to their functionality. 

To control the acquisition of waveforms: 
ARM„ACQUISrTION, AUTO_SETUP, BANDWIDTH_LIMIT, 
INTERLEAVED, SAMPLE_CLOCK, SEGMENTS, STOP, 
*TRG, WAIT. 

To select vertical input parameters to capture waveforms: 
ATTENUATION, COUPLING, OFFSET, VOLT_DIV. 

To select time-base parameters to capture waveforms: 

TIME DIV, TRIG DELAY. 

To select trigger conditions to capture waveforms: 

TRIG COUPLING, TRIGJLEVEL, TRIG_MODE, 

TRIG PATTERN, TRIG_SELECT, TRIG_SLOPE. 



To set communication characteristics: 

COMM FORMAT, COMM_HEADER, COMM_HELP, 
COMM ORDER, COMM_RS232. 
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Cursor 



Display 



Function 



Hard Copy 



Save/Recall Setup 



Status 



Waveform Transfer 



Miscellaneous 



To perform measurements: 

CURSORMEASURE, CURSOR_SET, CURSOR_VALUE?, 
PARAMETER VALUE? , XY_CURSOR_ORIGIN, 
XY_CURSOR_SET, XY_CURSOR_VALUE? . 

To display waveforms: 

DISPLAY, DUAL_ZOOM, GRID, HORJMAGNIFY, 

HOR POSITION, INTENSITY, MULTI_ZOOM, SELECT, 
TRACE, VERT_MAGNIFY, VERT_POSITION, XY_ASSIGN, 
XY_DISPLAY, ZOOM. 

To display messages to a local user: 

CALL_HOST, KEY, MESSAGE. 

To perform mathematical operations on waveforms: 
DEFINE, FUNCTION_RESET, FUNCTION_STATE. 

To plot or print the contents of the display screen: 

HARDCOPY_SETUP, HARDCOPY_TRANSMIT, 
SCREEN_DUMP. 

To preserve and restore front-panel settings: 
PANEL_SETUP, *RCL, *RST, *SAV. 

To obtain status information and set up service requests: 

ALL_STATUS?, *CLS, CMR?, DDR?, *ESE, *ESR?, EXR?, 
INE, INR?, *IST?, *OPC, *PRE, *SRE, *STB?, URR?, *WAI. 

To preserve and restore waveforms: 

INSPECT?, STORE, TEMPLATE?, WAVEFORM, 
WAVEFORM SETUP, WAVEFORM TEXT. 

To control the calibration and test the instrument: 

AUTO CALIBRATE, *CAL?, *TST?. 

To control the real-time clock: 

DATE. 

To control the built-in buzzer: 

BUZZER. 

To identify the instrument: 

*IDN?, *OPT?. 
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COMMAND EXECUTION Before attempting to execute a command or query, the oscillo- 
scope scans it to verify its correctness and that sufficient 
information is given to perform the requested action. To protect 
the local user from changes in the oscilloscope’s behavior which 
are beyond his control, the remote user must set the oscilloscope 
to the remote state to execute commands that affect the operation 
of the instrument as an oscilloscope. If such a command is re- 
ceived while the oscilloscope is operating in the local state, an 
execution permission error is generated and the execution of the 
command is denied. Vice versa, the local user cannnot interfere 
with the remote user because all front-panel controls are disabled 
while the oscilloscope is in the remote state. 

Since interrogating the oscilloscope does not change its internal 
state, it may be queried at any time, independently of local or 
remote operation. There are only two exceptions to this rule: the 
queries *CAL? and *TST? both recalibrate the oscilloscope and 
are therefore executed in the remote state only. 

Commands that only affect the remote behavior are executed in- 
dependently of whether the oscilloscope is in the local or remote 
state. In this category are all commands that modify communica- 
tion parameters (COMM_FORMAT, COMMHEADER, 
COMM_HELP, COMM_ORDER, COMM_RS232), all com- 
mands affecting status information (*CLS, *ESE, INE, *OPC, 
*PRE, *SRE, *WAI), and the commands used to display messages 
on the screen to the local user (CALL_HOST, KEY, MESSAGE) . 

In the description of each command, only exceptions to the rule 
that a command is executed only in the remote state and a query is 
executed in both the local and remote states are mentioned. 



COMMAND NOTATION The following notation is used in the description of the individual 

commands : 

< > Angular brackets enclose words that are used as placehold- 
ers. There are two types of placeholders: (1) the header 
path, (2) a data parameter of a command. 

:= A colon followed by an equals sign separates a placeholder 
from the description of the type and range of values that may 
be used in a command instead of the placeholder. 

{ } Braces enclose a list of choices from which one must be se- 
lected. 

[ ] Square brackets enclose optional items. 

An ellipsis indicates that the items to the left and to the right 
of the ellipsis may be repeated zero or more times. 
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As an example, consider the syntax notation for the command to 
set the vertical input sensitivity: 

<channel>:VOLT_DIV <v_gain> 

<channel> := {Cl, C2} 

< v_gain > := 5.0 mV to 2.5 V 

The first line shows the formal appearance of the command with 
<channel> denoting the placeholder for the header path, and 
< v_gain > denoting the placeholder for the data parameter specify- 
ing the desired vertical gain value. The second line indicates that 
either “Cl” or “C2” must be chosen for the header path, and the 
third line explains that the actual vertical gain can be set to any 
value between 5 mV and 2.5 V. 
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STATUS 

DESCRIPTION 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



RELATED COMMANDS 



ALLJSTATUS?, ALST? 

Query 



The ALL STATUS? query reads and clears the contents of all 
status registers: STB, ESR, INR, DDR, CMR, EXR, and URR ex- 
cept the MAV bit (bit 6) of the STB register. For an interpretation 
of the contents of each register, refer to the appropriate status 
register. 

The ALLJSTATUS? query is useful if a complete overview of the 
state of the instrument is required. 

ALl_STatus? 

ALl_STatus STB,<value>,ESR,<value>,INR,<value>, 
DDR,<value>, CMR<value>, EXR,<value>, URR, <value> 

<value> := 0 to 65535 

The following instruction reads the contents of all the status regis- 
ters. 

CMD$=” ALST?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

ALST STB, 000000, ESR, 000052, INR, 000005, DDR, 000000, 
EXR, 000024, CMR, 000004, URR, 000000 

*CLS, CMR?, DDR?, *ESR?, EXR?, *STB?, URR? 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 

RELATED COMMANDS 



ARM ACQUISITION, ARM 

Command 



The ARM_ACQUISITION command enables the signal acquisi- 
tion process by changing the acquisition state from “triggered” to 
“ready”. 

ARM_acquisition 

The following command enables signal acquisition. 

CMD$ = ”ARM”: CALL IB WRT (SCOPE% , CMD $ ) 

STOP, *TRG, TRIG_MODE, WAIT 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 
EXAMPLE (GPIB) 



$ 9424 only 



ATTENUATION, ATTN 

Command/Query 



The ATTENUATION command selects the vertical attenuation 
factor of the probe. Values of 1, 10, 100, 1000 or 10000 may be 
specified. 

The ATTENUATION? query returns the attenuation factor of the 
specified channel. 

<channel> : ATT eNuation <attenuation> 

<channel> := {Cl, C2, C3$, C4$} 

<attenuation>:= {1, 10, 100, 1000, 10000} 

<channel> : ATT eNuation? 

<channel> : ATT eNuation <attenuation> 

The following command sets the attenuation factor of channel 1 to 

100 . 

CMD$=”C1:ATTN 100”: CALL IBWRT(SCOPE%,CMD$) 
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MISCELLANEOUS 



AUTO_CALIBRATE, ACAL 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 
EXAMPLE (GPIB) 



The AUTO_CALIBRATE command is used to enable or disable 
automatic calibration of the instrument. At power-up, auto-cali- 
bration is turned ON, i.e. all input channels are periodically 
calibrated for the current gain, bandwidth and time-base settings. 

The automatic calibration may be disabled by issuing the com- 
mand ACAL OFF. Whenever it is convenient, a *CAL? query 
may be issued to fully calibrate the oscilloscope. When the oscillo- 
scope is returned to local control, the periodic calibrations will be 
resumed. 

The response to the AUTO_CALIBRATE? query indicates 
whether auto-calibration is enabled. 

Auto_CALibrate <state> 

<state> := {ON, OFF} 

Auto_CALibrate? 

Auto_CALibrate <state> 

The following instruction disables auto-calibration. 
CMD$=”ACAL OFF”: CALL IBWRT(SCOPE%,CMD$) 



RELATED COMMANDS 



CAL? 



System Commands 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 
EXAMPLE 



AUTO SETUP, ASET 

Command 



The AUTO_SETUP attempts to display the input signal (s) by ad- 
justing the vertical, time-base and trigger parameters. Auto-setup 
operates only on the channels whose traces are currently turned 
on. The only exception occurs when no traces are turned on, in 
which case AUTO_SETUP operates on all channels and turns on 
all of the traces. 

If signals are detected on several channels, the lowest numbered 
channel with a signal determines the selection of the time base and 
trigger source. 

If only one input channel is turned on, the time base will be ad- 
justed for that channel. 

Auto_SETup 

The following command instructs the oscilloscope to perform an 
auto-setup. 

CMD$ = ”ASET”: CALL IBWRT(SCOPE%,CMD$) 
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ACQUISITION 



BANDWIDTH_LIMIT, BWL 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 
EXAMPLE 



The BANDWIDTH_LIMIT command enables or disables the 
bandwidth limiting low pass filter. 

The response to the BANDWIDTHJLIMIT? query indicates if the 
bandwidth filter is on or off. 

Bandwidth JLimit <mode> 

<mode> := {ON, OFF} 

BandWidth__Limit? 

BandWidth Limit <mode> 

The following command turns the bandwidth filter on. 

CMD$ = "BWL ON”: CALL IBWRT(SCOPE%,CMD$) 
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MISCELLANEOUS 

DESCRIPTION 



COMMAND SYNTAX 
EXAMPLE (GPIB) 



System Commands 



BUZZER, BUZZ 

Command 



The BUZZER command controls the built-in piezo-electric buzz- 
er. This may be useful to attract the attention of a local operator in 
an interactive working application. The buzzer may either be acti- 
vated for short beeps (about 400 msec long in BEEP mode) or 
continuously for a certain time interval selected by the user by 
turning the buzzer ON or OFF. A beep request which immediately 
follows another beep request will be held off for approximately 
200 msec. 

Note: This command is always accepted ( local and remote). 
BUZZer := {BEEP, ON, OFF} 

Sending the following code will cause the oscilloscope to sound two 
short tones. 

CMD$ = “BUZZ BEEP; BUZZ BEEP”; 

CALL IBWRT (SCOPE%, CMD$) 
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MISCELLANEOUS 



*CAL? 

Query 



DESCRIPTION The *CAL? query performs a complete internal calibration. This 

calibration sequence is the same as that which occurs at power-up. 
At the end of the calibration, the response indicates how the cali- 
bration terminated. When the calibration is finished, the 
instrument returns to the state it was in prior to the query. 

Hardware failures are identified by a unique binary code in the 
returned <status> number (see Table 1 ) . A “0” response indicates 
that no failures occurred. 

Note: This query is only accepted in remote mode. 

QUERY SYNTAX *CAL? 

Response Format *CAL <diagnostics> 

<diagnostics> := 0 calibration successful 



BIT 


BIT VALUE 


DESCRIPTION 


0 


1 


CHI failure 


1 


2 


CH2 failure 


2 


4 


CH3 failure^ 


3 


8 


CH4 failure^ 


4 


16 


TDC failure 


5 


32 


Trigger circuit failure 



Failures 
Table 1 



EXAMPLE (GPIB) The following instruction forces a self-calibration. 

CMD$=” *CAL?”: CALL IBWRT(SCOPE%,CMD$) 
CALL IBRD(SCOPE%,RD$): PRINT RD$ 

Response message (if no failure) 

*CAL 0 

RELATED COMMANDS AUTO_CALIBRATE 

$ 9424 only, reserved in the 9420/50 



46 




System Commands jjy 



DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



CALL HOST, CHST 

Command/Query 



The CALL_HOST command allows the user to manually generate 
a service request (SRQ). Once the CALL_HOST command has 
been received, the message “Call Host” will be displayed next to 
the lowest button (10) in the menu field (II). Pressing this button 
while in the root menu causes the User Request status Register 
(URR) and the URQ bit of the Event Status Register to be set. This 
can generate a SRQ in local mode provided that the service re- 
quest mechanism has been enabled. 

The response to the CALLJHOST? query indicates whether call 
host is enabled (on) or disabled (off). 

Note: This command can be executed in both local and remote 
modes. 

Call_HoST <state> 

<state> := {ON, OFF} 

Call_HoST? 

Call_HoST <state> 

After executing the following code an SRQ request will be gener- 
ated whenever button 10 is pressed. It is assumed that SRQ 
servicing has already been enabled. 

CMD$=”CHST ON”: CALL IBWRT(SCOPE%,CMD$) 

URR? 
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STATUS *CLS 

Command 



DESCRIPTION The *CLS command clears all the status data registers. 

Note: This command can be executed in both local and remote 
modes. 



COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*CLS 

The following command causes all the status data registers to be 
cleared. 

CMD$ = “ *CLS”: CALL IBWRT(SCOPE%,CMD$) 

ALL STATUS?, CMR?, DDR?, *ESR?, EXR?, *STB?, URR? 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



CMR? 

Query 



The CMR? query reads and clears the contents of the CoMmand 
error Register (CMR). The CMR register (Table 2) specifies the 
last syntax error type detected by the instrument. 

CMR? 

CMR <value> 

<value> := 1 to 13 

The following instruction reads the contents of the CMR register. 
CMD$=”CMR?”: CALL IBWRT(SCOPE%,CMD$) 

fAT T iDDnAcr r\ nc cz. r> or><!'\ . nm\TT nmc 
H zv, Jcvor g> y . r rvii> 1 rv jro 

Response message 
CMR 0 

ALL_STATUS?, *CLS 



Value 


Description 


1 


Unrecognized command/query header 


2 


illegal header path 


3 


Illegal number 


4 


Illegal number suffix 


5 


Unrecognized keyword 


6 


String error 


7 


GET embedded in another message 


10 


Arbitrary data block expected 


11 


Non-digit character in byte count field of arbitrary 
data block 


12 


EOI detected during definite length data block 
transfer 


13 


Extra bytes detected during definite length data 
block transfer 



Command Error Status Register Structure (CMR) 
Table 2 
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COMMUNICATION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
EXPLANATION 



COMM_FORMAT, CFMT 

Command/Query 



The COMM_FORMAT command selects the format which the 
oscilloscope will use to send waveform data. The available options 
allow (1) the block format, (2) the data type and (3) the encoding 
mode to be modified from the default settings. 

Note: This command can be executed in both local and remote 
modes. 

The COMM_FORMAT? query returns the currently selected 
waveform data format. 

Comm_ForMaT <block_format>,<data_type>,<encoding> 

<block_format> := {DEF9, INDO, OFF} 

<data_type> := {BYTE, WORD} 

<encoding> := {BIN, HEX} 

(GPIB uses both encoding forms, RS-232-C always uses HEX) 

Initial settings (i.e. after power on) are: 

DEF9, WORD, BIN for GPIB 
DEF9, WORD, HEX for RS-232-C 

Comm_ForMaT? 

Comm_ForMaT <block_format>,<data_type>,<encoding> 

The following code redefines the transmission format of waveform 
data. The data will be transmitted as a block of indefinite length. 
Data will be coded in binary and represented as 8-bit integers. 

CMD$=”CFMT INDO, BYTE, BIN” 

CALL IBWRT(SCOPE%,CMD$) 

BLOCK FORMAT 

DEF9: Uses the IEEE 488.2 definite length arbitrary block re- 

sponse data format. The digit 9 indicates that the byte 
count consists of 9 digits. The data block directly follows 
the byte count field. 

For example, a data block consisting of 3 data bytes 
would be sent as: 

WF DATl,#9000000003<DABxDABxDAB> 
where <DAB> represents an 8 -bit binary data byte. 
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INDO: Uses the IEEE 488.2 indefinite length arbitrary block 

response data format. 

A <NL"END> (new line with EOI) signifies that block 
transmission has ended. 

The same data bytes as above would be sent as: 

WF DAT 1 ,#0<DABxDABxD ABxNIA END> 

OFF: Same as INDO. In addition, the data block type identi- 

fier and the leading #0 of the indefinite length block will 
be suppressed. The data presented above would be sent 
as: 

WF <DABxDABxDABxNL A END> 

Note: The format OFF does not conform to the IEEE 488.2 stan- 
dard and is only provided for special applications where the 
absolute minimum of data transfer may be important. 

DATA TYPE 

BYTE: Transmits the waveform data as 8-bit integers (1 byte). 

WORD: Transmits the waveform data as 16-bit integers 
(2 bytes). 

ENCODING 

BIN: Binary encoding (GPIB only) 

HEX: Hexadecimal encoding (bytes are converted to 2 hexa- 

decimal ASCII digits (0, ... 9, A, ... F)) 

RELATED COMMANDS WAVEFORM? 
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COMMUNICATION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



COMMJHEADER, CHDR 

Command/Query 



The COMMHEADER command controls the way the oscillo- 
scope will format responses to queries. The instrument provides 
three response formats: (1) LONG format, i.e. responses start 
with the long form of the header word; (2) SHORT format, i.e. 
responses start with the short form of the header word; (3) OFF, 
i.e. headers are omitted from the response and suffix units in num- 
bers are suppressed. Until the user requests otherwise, the SHORT 
response format is used. 

This command does not affect the interpretation of messages sent 
to the oscilloscope. Headers may be sent in their long or short 
form regardless of the COMMJHEADER setting. 

Querying the vertical sensitivity of Channel 1 may result in one of 
the following responses: 



COMMJHEADER 


RESPONSE 


LONG 


CHANNEL_1 :VOLT_DIV 200E-3 V 


SHORT 


Cl :VDIV 200E-3 V 


OFF 


200E-3 



Note: This command can be executed in both local and remote 
modes. 

Comm_HeaDeR <mode> 

<mode> := {SHORT, LONG, OFF} 

Note: The default mode, i.e. the mode just after power on, is 
SHORT. 

Comm_HeaDeR? 

Comm_HeaDeR <mode> 

The following code sets the response header format to short. 
CMD$ = ”CHDR SHORT”; CALL IBWRT(SCOPE%,CMD$) 
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COMMUNICATION 



COMMJHELP, CHLP 

Command/Query 



DESCRIPTION 



COMMAND SYNtAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The COMM HELP command enables the help diagnostics utility 
to assist remote program debugging. When turned on, this utility 
displays all message transactions occurring between the controller 
and the oscilloscope on a terminal, printer or similar recording 
device connected to the RS-232-C port. Errors detected by the 
instrument can be directly viewed. 

Note: This command can be executed in both local and remote 
modes . 

The COMM_HELP? query indicates if the diagnostics utility has 
been enabled. 

Comm_HeLP <target> 

<target> := {RS, OFF} 

The initial <target>, (i.e. after power on) is OFF. 

Comm_HeLP? 

Comm__HeLP <target> 

The following code turns on the remote control diagnostics utility. 
CMD$=”CHLP RS”; CALL IBWRT(SCOPE%,CMD$) 
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COMMUNICATION 



COMM ORDER, CORD 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE 



The COMM_ORDER command controls the byte order of wave- 
form data transfers. Waveform data may be sent with the most 
significant byte (MSB) or the least significant byte (LSB) in the 
first position. The default mode is the MSB first. 

COMM ORDER applies equally to the waveform’s descriptor and 
time blocks. In the descriptor some values are 16 bits long 
(“word”), 32 bits long (“long ” or “float”), or 64 bits long (“dou- 
ble”). In the time block all values are floating values, i.e. 32 bits 
long. When “COMM_ORDER HI” is selected the most significant 
byte is sent first. When “COMM_ORDER LO” is specified the 
least significant byte is sent first. 

The COMM_ ORDER? query returns the byte transmission order 
currently in use. 

Note: This command can be executed in both local and remote 
modes. 

Comm_ORDer <mode> 

<mode> := (HI, LO} 

Note: The initial mode, i.e. the mode after power on, is HI. 

Comm_ORDer? 

Comm_ORDer <mode> 

The order of transmission of waveform data depends on the data 
type. Table 3 illustrates the different possibilities. 
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CORD HI 


CORD LO 


Word 


<MSBxLSB> 


<LSBxMSB> 


Long/float 


<MSBxbyte 2xbyte 3xLSB> 


cLSBxbyte 3xbyte 2xMSB> 


Double 


<MSBxbyte 2> ... <byte 7xLSB> 


<LSBxbyte 7> ... <byte 2xMSB> 



Waveform Data Transmission Order 
Table 3 

RELATED COMMANDS WAVEFORM? 
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COMMUNICATION 



DESCRIPTION 



COMMJRS232, CORS 

Command/Query 



The command COMMJRS232 sets the parameters of the 
RS-232-C port for remote control. 

The COMM_RS232? query reports the settings of the parameters. 

Note: This command is ONLY valid if the oscilloscope is being 
remotely controlled via the RS-232-C port. 

The parameters are: 

a. DUPLEX behavior mode. 

b. End Input character. When received by the oscilloscope, this 
character will be interpreted as the END-of-a-command 
message marker. The commands received will be parsed and 
executed. 

c. End Output string. The oscilloscope will add this string at the 
end of a response message. When the host computer receives 
this string, it knows that the oscilloscope has completed its 
response. 

d. Line Length. This parameter defines the maximum number 
of characters that will be sent to the host in a single line. 
Remaining characters of the response will be output in sepa- 
rate additional lines. This parameter is only applicable if a 
line separator has been selected. 

e. Line Separator. This parameter is used to select the line split- 
ting mechanism and to define the characters used to split the 
oscilloscope response messages into many lines. Possible line 
separators are: CR, LF, CRLF. A <CR>, a <LF> or a <CR> 
followed by a <LF> will be sent to the host computer after 
<line__length> characters. 

f. SRQ string. This string is sent each time the oscilloscope 
wants to signal an SRQ to the host computer. 

Note: Some parameters of this command require ASCII strings as 
actual arguments. In order to facilitate the embedding of non- 
printable characters into such strings, escape sequences may be 
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used, the back-slash character (’\‘) is used as an escape charac- 
ter. The following escape sequences are recognized: 

“\a”: Bell character, 

“\b Back space character, 

“\e Escape character, 

“\n”: Line feed character, 

“\r": Carriage return character, 

“\t”: Horizontal tab character, 

The back-slash character itself 

“\ddd”: ddd represents one to three decimal digit characters giv- 
ing the code value of the corresponding ASCII 
character. This allows any ASCII code in the range 1 to 
127 to be inserted. 



Before using the string, the oscilloscope will replace the escape 
sequence by the corresponding ASCII character. 



For example, the escape sequences ‘‘Sr”, “\13" and “ \013 " are 
all replaced by the single ASCII character <Carriage Return>. 



Notation 

DUPLEX duplex 
EO End output string 

LS Line separator 



El End input character 

LL Line length 

SRQ SRQ Service request 



COMMAND SYNTAX COmm_RS232 DUPLEX, <duplex>, El, <ei_char>, 

E O , ’ <e o_string> ’ , LL , <line_length> , L S , <Line_sep> , 

SRQ, ’<srq_string>’ 

<duplex> := FULL (only full duplex is currently implemented) 

<ei__char> := 1 to 126 (default: 13 = <CR>) 

<eo_string> := A non-empty ASCII string of up to 20 characters. 

(default: “\n\r”) 

<linejength> := 40 to 1024 (default: 256) 

<line_sep> := {OFF, CR, LF, CRLF} (default: OFF) 

< srq_string > := An ASCII string which may be empty. 

(default: empty string) 
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QUERY SYNTAX 
Response Format 



EXAMPLE 



COmm_RS232? 

COmm_RS232 DUPLEX, <duplex>, El, <ei_char>, 

EO , ” <eo__string>” , 

LL,<line__length>,LS,<line_sep>,SRQ,”<srq_string>” 

After executing the command 

COMM RS232 EI,3,EO,”\R\NEND\R\N” 

the oscilloscope will assume that it has received a complete mes- 
sage each time the <ETX> (decimal value 3) is detected. Response 
messages will be terminated by sending the character sequence 
“ <CR><LF>END<CRxLF>” . 
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ACQUISITION 



COUPLING, CPL 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE GPIB) 



The COUPLING command selects the coupling mode of the speci- 
fied input channel. 

The COUPLING? query returns the coupling mode of the speci- 
fied channel. 

<channel>:CouPLing <coupling> 

<channel> := {Cl, C2, C3$, C4$} 

<coupling> := {AIM, DIM, D50, GND} 

<channel> : CouPLing? 

<channel>:CouPLing <coupling> 

The following command sets the coupling of Channel 2 to 
50 H DC. 

CMD$=”C2:CPL D50”: CALL IBWRT(SCOPE%,CMD$) 



$ 9424 only 
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CURSOR 



CURSORJMEASURE, CRMS 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The CURSOR_MEASURE command specifies the type of cursor 
to be displayed. 

The CURSOR_MEASURE? query indicates which cursors are 
currently displayed. 



Notation 



HABS 


Horizontal absolute 


HREL 


Horizontal relative 


VABS 


Vertical absolute 


VREL 


Vertical relative 


PARAM 


Parameters 


OFF 


Cursors off 



Note: The PARAM mode is turned OFF when the XY mode is ON. 
CuRsor_MeaSure <mode> 

<mode> := {HABS, VABS, HREL, VREL, PARAM, OFF} 

CuRsor_MeaSure? 

CuRsor_MeaSure <mode> 

The following command switches on the vertical relative cursors. 

CMD$=”CRMS VREL”: CALL IBWRT(SCOPE%,CMD$) 

The following command determines which cursor is currently 
turned on. 

CMDS$=”CRMS?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$): PRINT RD$ 

Example of response message 
CRMS OFF 
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CURSOR 



DESCRIPTION 



$ 9424 only 



CURSORSET, CRST 

Command/Query 



The CURSOR_SET command allows the user to position any one 
of the eight independent cursors at a given screen location. The 
positions of the cursors can be modified or queried even if the 
required cursor is not currently displayed on the screen. 

When setting a cursor position, a trace must be specified, relative 
to which the cursor will be positioned. 

The CURSOR SET? query indicates the current position of the 
cursor (s). The values returned depend on the grid type selected. 

Note 1: When the oscilloscope is in the dual grid mode, traces are 
assigned to either the upper grid (EA, MC, FE, Cl , C3$) or lower 
grid (EB, MD, FF, C2, C4$). The trace specified determines 
whether a vertical cursor will be placed relative to the upper or 
lower grid. 

In quad grid mode% each channel is permanently assigned to its 
respective grid with Cl at the top and C4 at the bottom. All other 
traces may be re-positioned anywhere on the screen using the ver- 
tical position control. 

Note 2: If the parameter display is turned on, the parameters of 
the specified trace will be shown unless the newly chosen trace is 
not displayed or has been acquired in sequence mode ( these condi- 
tions will produce an environment error, see Table 6, page 82). To 
only change the trace without repositioning the cursors, the CUR- 
SOR_SET command may be given with no argument, (e.g. 
EB-.CRST). 



Notation 






HABS Horizontal absolute 
VABS Vertical absolute 
HREF Horizontal reference 


HDIF 


Horizontal difference 


VREF Vertical reference 


VDIF 


Vertical difference 


PREF Parameter reference 


PDIF 


Parameter difference 
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COMMAND SYNTAX 



QUERY SYNTAX 



Response Format 



EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 9424 only 



<trace>:CuRsorJSeT <cursor>,<position>[<cursor>,<position>, 

. . .<cursor>,<position>] 

<trace> := (EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 
<cursor> := {HABS, VABS, HREF, HDIF, VREF, VDIF, 
PREF, PDIF} 

<position> := 0 to 10 DIV (horizontal) 

-13 to 13 DIV (vertical) 

Note 1: The suffix DIV is optional. 

Note 2: Parameters are grouped in pairs. The first parameter 
specifies the cursor to be modified and the second one indicates its 
new value. Parameters may be grouped in any order and may be 
restricted to those items to be changed. 

<trace>:CuRsor__SeT? [<cursor>, . . .<cursor>] 

<cursor>:= {HABS, VABS, HREF, HDIF, VREF, VDIF, PREF, 
PDIF, ALL} 

<trace>:CuRsor_SeT <cursor>, <position> [<cursor> , <position>, 

. . .<cursor>,<position>] 

If <cursor> is not specified, ALL will be assumed. If the position 
of a cursor cannot be determined in a particular situation, its posi- 
tion will be indicated as UNDEF. 

The following command positions the VREF and VDIF cursors at 
+3 DIV and -7 DIV respectively, using Function E as a reference. 

CMD$=”FE:CRST VREF, 3DIV, VDIF, -7DIV” 

CALL IBWRT(SCOPE%,CMD$) 

CURSOR VALUE?, PARAMETER_VALUE? 
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CURSOR 



DESCRIPTION 



QUERY SYNTAX 



Response Format 



EXAMPLE (GPIB) 



RELATED COMMANDS 

$ 9424 only 



CURSOR VALUE?, CRVA? 

Query 



The CURSOR VALUE? query returns the values measured by 
the specified cursors for a given trace. (The PARAME- 
TER_VALUE? query is used to obtain measured waveform 
parameter values.) 



Notation 






HABS Horizontal absolute 


HREL 


Horizontal relative 


VABS Vertical absolute 


VREL 


Vertical relative 



<trace>:CuRsor_VAlue? [<mode>, . . .<mode>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 
<mode> := {HABS, VABS, HREL, VREL, ALL} 



<trace>:CuRsor_VAlue? <mode> [ , <hor_value>] ,<ver_value>[, 

. . . , <mode> [ , <hor_value>] ,<ver_value>] 

For horizontal cursors, both horizontal as well as vertical values 
are given, whereas for vertical cursors only vertical values are 
given. 

Note: If <mode> is not specified or equals ALL, all the measured 
cursor values for the specified trace are returned. If the value of a 
cursor could not be determined in the current environment, the 
value UNDEF will be returned. 

The following query reads the measured absolute horizontal value 
of the cross-hair cursor (HABS) on Channel 2. 

CMD$=”C2:CRVA? HABS”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

”C2:CVRA HABS, 34. 2 US, 244 MV” 

CURSOR SET 



63 




System Commands 



MISCELLANEOUS 



DATE 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



The DATE command changes the date/time of the oscilloscope’s 
internal real time clock. 

The DATE? query returns the current date/time setting. 

DATE <day>,<month>,<year>,<hour>,<minute>,<second> 

<day> := 1 to 31 

<month> := {JAN, FEB, MAR, APR, MAY, JUN, JUL, 

AUG, SEP, OCT, NOV, DEC} 

<year> := 1987 to 2500 
<hour> := 0 to 23 
<minute> := 0 to 59 
<second> := 0 to 59 

Note: It is not always necessary to specify all the DATE parame- 
ters. Only the parameters up to and including the parameter to be 
changed need to be specified , i.e. to change the " year ” setting 
specify day, month and year together with the required settings. 
The time settings will remain unchanged. To change the “ second ” 
setting all the DATE parameters must be specified with the re- 
quired settings. 

DATE? 

DATE <day>,<month>,<year>,<hour>,<minute>,<second> 

This example will change the date to October 1,88 and the time to 
1:21:16 p.m. (13:21:16 in 24 hour notation). 

CMD$=” DATE l,OCT, 1988, 13,21, 16” 

CALL lBWRT(SCOPE%,CMD$) 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



DDR? 

Query 



The DDR? query reads and clears the contents of the Device De- 
pendent or device specific error Register (DDR) . In the case of a 
hardware failure, the DDR register specifies the origin of the fail- 
ure. Refer to Table 4, page 66, for further details. 

DDR? 

DDR <value> 

<value> := 0 to 65535 



The following instruction reads the contents of the DDR register. 



»r\r\-now . a t t TDnm r r/or i Anr , ^_ 

- ljujxi ; jl, ijd w iv i 



CALL IBRD(SCOPE%,RSP$) : PRINT RSP$ 



Response message 



DDR 0 

ALL_STATUS?, *CLS 
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Bit 


Bit Value 




Description 


15. .14 




0 


Reserved 


13 


8192 


1 


time-base hardware 
failure is detected 


12 


4096 


1 


a trigger hardware 
failure is detected 


11 


2048 


1 


a Channel 4$ hardware 
failure Is detected. 


10 


1024 


1 


a Channel 3$ hardware 
failure is detected. 


9 


512 


1 


a Channel 2 hardware 
failure is detected 


8 


256 


1 


a Channel 1 hardware 
failure is detected 


7. .4 




0 


Reserved 


3 


8 


1 


a Channel 4$ overload 
condition is detected 


2 


4 


1 


a Channel 3$ overload 
condition is detected 1 


1 


2 


1 


a Channel 2 overload 
condition is detected 


0 


1 


1 


a Channel 1 overload 
condition is detected 



Device Specific Register Structure (DDR) 
Table 4 



$ 9424 only, reserved in 9420/50 
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FUNCTION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 



$ 9424 only 



DEFINE, DEF 

Command/Query 

Standard Oscilloscopes 



The DEFINE command specifies the mathematical expression to 
be evaluated by a function. 



Notation 

MAXPTS 


maximum number of points 


SWEEPS 


maximum number of sweeps 


EQN 


equation 


AVGS average summed 


Cl 


Channel 1 


C2 Channel 2 


C3 


Channel 3$ 


C4 Channel 4$ 



<function> : DEFine EQN , ’ <equation>’ , MAX PTS ,<max_points> , 
S WEEPS, <max_sweeps> 

<function> := {MCf, MD$, FE, FF} 

<equation> := {<source>, - <source>, <source> + <source>, 
<source> - <source>, AVGS (<source>) } 

<source> := {Cl, C2, C3$, C4$} 

<max__points> := 50 to 50000 on 1-2-5 scale 
<max_sweeps> := 1 to 1000 

Note 1: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be given in any order and may be restricted 
to the variables to be changed. 

Note 2: The pair SWEEPS ,<max_sweeps> applies only when aver- 
aging (AVGS) has been chosen. Otherwise it is ignored. 



<function> : DEFine? 

<function>:DEFine EQN, ’<equation>’ ,MAXPTS,<max_points> 
[ , SWEEPS , <max_sweeps>] 
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EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 9424 only 



The following command defines Function E (FE) to compute the 
summed average of Channel 1 using 5000 points over 200 sweeps. 

CMD$=”FE:DEF EQN,’AVGS(C1)’, 

MAXPTS, 5000, SWEEPS, 200” 

CALL IBWRT(SCOPE%,CMD$) 

FUNCTION_RESET, FUNCTION_STATE$, INR? 
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FUNCTION 



DESCRIPTION 



DEFINE, DEF 

Command/Query 
Oscilloscopes fitted with the WP01 Option 



An oscilloscope fitted with the Waveform Processing option 
(WP01) accepts additional forms of the DEFINE command: 



Processing Notation 


ABS 


Absolute Value 


AVGC 


Continuous Average 


AVGS 


Summed Average 


DER! 


Derivative 


EXP 


Exponential (power of e) 


EXP10 


Exponential (power of 10) 


EXTR 


Extrema 


FLOOR 


Floor (Extrema only) 


HRES 


High Resolution Filter 


INTG 


Integral 


LOG 10 


Logarithm base 10 


LN 


Logarithm base e 


ROOF 


Roof (Extrema only) 


SQR 


Square 


SORT 


Square Root 


+ 


Identity or Add 


- 


Negation or Subtract 


* 


Multiply 


/ 


Ratio 


1/ 


Reciprocal 



69 





System Commands 

.. I 

J 



Key words 




BITS 


Resolution enhancement, bits {High Resolu- 
tion only) 


DITHER 


Dither (Summed Average only) 


MAXPTS 


Maximum number of points 


REJECT 


Reject overflow/underflow (Summed Aver- 
age only) 


SWEEPS 


Maximum number of sweeps (Average and 
Extrema only) 


WEIGHT 


Weight (Continuous Average only) 



COMMAND SYNTAX <function> : DEFine EQN , ’ <equation>’ , MAXPTS,<max_points>, 

S WEEPS, <max__sweeps>, DITHER, <off_on>, 

REJECT, <off_on>, WEIGHT, <weight>, BITS,<bits> 

<function> := {MC$, MD$, FE, FF} 

<equation> := AVGS(<source>) Summed Average 

<equation> := AVGC(<source>) Continuous Average 

<equation> := <paren_source_expr> Identity 

<equation> := +<paren_source_expr> Identity 

<equation> := -<paren_source_expr> Negation 

<equation> := l/<paren_source__expr> Reciprocal 

<equation> := <paren_source_expr> + <source> 

Addition 

<equation> := <paren_source_expr> - <source> 

Subtraction 

<equation> := <paren_source_expr> ♦ <source> 

Multiplication 

<equation> := <paren__source_expr> / <source> 

Ratio 

<equation> := EXTR(<source>) Extrema (R+F) 

$ 9424 only 
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<equation> := FLOOR (EXTR(<source>)) Floor 

<equation> := ROOF (EXTR(<source>) ) Roof 

<equation> := S QR (<source_expr>) Square 

<equation> := SQRT (<source_expr>) Square Root 

<equation> := LN (<source_expr>) Logarithm base e 

<equation> := LOG10(<source_expr>) Logarithm base 10 
<equation> := EXP(<source_expr>) Power of e 

<equation> := EXP10(<source_expr>) Power of 10 

<equation> := INTG(<source_expr>) Integral 

<equation> := DERI (<source_expr>) Derivative 

<equation> := ABS (<source_expr>) Absolute Value 

<equation> := HRES(<source>) High Resolution 

<paren_source_expr> := (<source__expr>) 

<paren_source_expr> := <source> 

<source_expr> := <multiplier> * <source> {+, -} <addend> 
<source_expr> := <multiplier> * <source> 

<source_expr> := <source> {+, -} <addend> 

<source_expr> := <source> 

<multiplier> := 0.001e-33 to 999.999e33 

<addend> := - 999.999e33 to 999.999e33 

<source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, 04$} 

<max__points> := 40 to 50000 

<max_sweeps> := 1 to 1000000 

<off_on> := {OFF, ON} 

<weight> := {1, 3, 7, 15, 31, 63, 127} 

<bits> := {0.5, 1.0, 1.5, 2.0, 2.5, 3.0} 

Note: Space (blank) characters inside equations are optional. 



$ 9424 only 
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QUERY SYNTAX 
Response format 

EXAMPLE (GPIB): 



RELATED COMMANDS 



$ 9424 only 



<function>: DEFINE? 

<function>:DEFine EQN,’<equation>\ MAXPTS,<max_points>, 
SWEEPS ,<max_sweeps>, DITHER, <off_on>, 

REJECT, <off_on>, WEIGHT, <weight>, BITS,<bits> 

The following command defines Function E to compute the prod- 
uct of (Channel 1 multiplied by 2.1 and augmented by 3.3) and 
Channel 2, using a maximum of 10000 input points: 

CMD$=”FE:DEF EQN,’(2.1*Cl+3.3) *C2\ MAXPTS, 10000” 

CALL IBWRT(SCOPE%,CMD$) 

FUNCTION RESET, FUNCTION_STATE$ , INR? 
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FUNCTION 



DESCRIPTION 



COMMAND SYNTAX 



$ 9424 only 



DEFINE, DEF 

Command/ Query 



Oscilloscopes fitted with the WP02 Option 



An oscilloscope fitted with the FFT option (WP02) accepts addi- 
tional forms of the DEFINE command. 



Notation 




WINDOW 


FFT window function 


FFT 


Fast Fourier Transform (complex result) 


REAL 


Real part of complex result 


IMAG 


Imaginary part of complex result 


MAG 


Magnitude of complex result 


PHASE 


Phase angle (degrees) of complex result 


PS 


Power Spectrum 


PSD 


Power Density 


AVGP 


Power Average 


RECT 


Rectangular window 


HANN 


von Hann window 


HAMM 


Hamming window 


FLTP 


Flat Top window 


BLHA 


Blackman-Harris window 


DCSUP 


DC component suppression 



(FFT) < function > :DEFine EQN/ < equation > \ 

MAXPTS, < maxpoints > , WINDOW, < windowtype > , 
DCSUP, < off_on > 

<function> := {MC$, MD$, FE, FF} 

<equation> := FFT (<source_expr>) 

<equation> := REAL (FFT (<source_expr>)) 

<equation> := IMAG(FFT(<source_expr>)) 

<equation> := MAG(FFT(<source__expr>)) 

<equation> := PHASE (FFT (<source_expr>) ) 

<equation> := PS(FFT(<source_expr>)) 

<equation> := PSD (FFT (<source_expr>) ) 

<source_expr> := <multiplier> * <source> {+, -} <addend> 
<source_expr> := <multiplier> * <source> 
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jjs System Commands 



QUERY SYNTAX 
Response Format 



EXAMPLE (GPIB) 



COMMAND SYNTAX 
(FFT Power Average) 



QUERY SYNTAX 
Response Format 



<source_expr> := <source> {+, -} <addend> 

<source__expr> := <source> 

<multiplier> := 0.00 le-33 to 999.999e33 

<addend> := -999.999e33 to 999.999e33 

<source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3*, C4$} 

<window_type> := {RECT, HANN, HAMM, FLTP, BLHA} 

<off_on> := {OFF, ON} 

Note: The source waveform must be a time domain signal. 



<function>:DEFine? 



<function>:DEFine EQN,’<equation>’,MAXPTS,<max_points>, 
WINDOW, <window_type>,DCSUP,<off_on> 



The following command defines Function E to compute the Power 
Spectrum of the FFT of Channel 1. Prior to FFT computation, 

3 1 t r> multmliar! Ktr 1 A1 Q onrl A A ^ ^ ( 1 1 rv itc r\f C* r\ ry 1 

-L Id AAAlXAtA|yAlC\»A wy A . V/ A O CAAAV4 X/ . V/ Vi J. f 

i.e. Volts) is added. A maximum of 1000 points will be used for 

the input. The window function is Rectangular. The DC compo- 

nent of the input is not suppressed. 



CMD$=”FE:DEF EQN,’PS(FFT(1.018*C1 + 0.055))’, 
MAXPTS, 1000, WINDOW, RECT, DCSUP, OFF” 

CALL IBWRT(SCOPE%,CMD$) 



< function > rDEFine EQN,’ < equation > 

SWEEPS, < maxsweeps > 

<equation> := MAG (A VGP (<source>) ) 

<equation> := PS ( AVGP (<source>) ) 

<equation> := PSD (A VGP (<source>) ) 

<source> := {MC$, MD$, FE, FF} 

<max_sweeps> := 1 to 50000 

Note: The source waveform must be another function defined as a 
Fourier transform. 

<function>:DEFine? 

<function>:DEFine EQN, ’<equation>’, SWEEPS, <max_sweeps> 



$ 9424 only 
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EXAMPLE (GPIB) The following command defines Function F to compute the Power 

Spectrum of the Power Average of the FFT being computed by the 
Function E, over a maximum of 244 sweeps. 

CMD$=”FF:DEF EQN, ’ PS (AVGP(FE))’, SWEEPS, 244” 

CALL IBWRT(SCOPE%,CMD$) 



RELATED COMMANDS FUNCTION JRESET, FUNCTION_STATE$ , INR? 



$ 9424 only 
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System Commands 



DISPLAY 



DISPLAY, DISP 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The DISPLAY command controls the display screen of the oscillo- 
scope. When the user is remotely controlling the oscilloscope and 
does not need to use the display, it may be useful to switch off the 
display via the DISPLAY OFF command. This improves instru- 
ment response time since the waveform graphic generation 
procedure is suppressed. 

The response to the DISPLAY? query indicates the display state of 
the oscilloscope. 

Note: When the display has been set to OFF, the real time clock 
and the message field are updated. However, the waveforms and 
associated texts remain unchanged. 

DISPlay <state> 

<state> := {ON, OFF} 

DISPlay? 

DISPlay <state> 

The following instruction turns off the display generation. 
CMD$=”DISP OFF”: CALL IBWRT(SCOPE%,CMD$) 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



System Commands 



5 



DUAL ZOOM , DZOM 

Command/Query 



By setting DUAL_ZOOM ON, the horizontal magnification and 
positioning controls apply to all expanded traces simultaneously. 
This command is useful if the contents of all expanded traces are 
to be examined at the same time. 

The DUAL_ZOOM? query indicates whether multiple zoom is en- 
abled or not. 

Note: This command has the same effect as MULTI _ZOOM . 

Dual_ZOoM <mode> 

<mode> := {ON, OFF} 

Dual_ZOoM? 

Dual_ZOoM <mode> 

The following example turns dual zoom on. 

CMD$=”DZOM ON”: CALL IBWRT(SCOPE%,CMD$) 

HOR_MAGNIFY, HOR_POSITION, MULTI_ZOOM, ZOOM 
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STATUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*ESE 

Command/Query 



The *ESE command sets the standard Event Status Enable regis- 
ter (ESE). This command allows one or more events in the ESR 
register to be reflected in the ESB summary message bit (bit 5) of 
the STB register. For an overview of the ESB defined events refer 
to the ESR table (Table 5, page 80). 

The *ESE? query reads the contents of the ESE register. 

Note: This command can be executed in both local and remote 
modes. 

*ESE <value> 

<value> := 0 to 255 

*ESE? 

*ESE <value> 

The following command allows the ESB bit to be set if a user re- 
quest (URQ bit 6, i.e. decimal 64) and/or a device dependent 
error (DDE bit 3, i.e. decimal 8) occurs. Summing these values 
yields the ESE register mask 64+8=72. 

CMD$=” *ESE 72”: CALL IBWRT(SCOPE%,CMD$) 

*ESR? 
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System Commands ^ 



STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*ESR? 

Query 



The *ESR? query reads and clears the contents of the Event Status 
Register (ESR). The response represents the sum of the binary 
values of the register bits 0 to 7, Refer to Table 5, page 80 for an 
overview of the ESR register structure. 

*ESR? 

*ESR <value> 

<value> := 0 to 255 

The following instruction reads and clears the contents of the ESR 
register. 

CMD$=” *ESR?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$) : PRINT RSP$ 

Response message 
*ESR 0 

ALL_STATUS? , *CLS, *ESE 
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Bit 


Bit Value 


Bit Name 


Description 


Note 


15. .8 






0 Reserved by IEEE 488.2 




7 


128 


PON 


1 a Power off-to-ON transition has occurred 


(D 


6 


64 


URQ 


1 a User ReQuest has been issued 


(2) 


5 


32 


CME 


1 a CoMmand parser Error has been found 


(3) 


4 


16 


EXE 


1 an Execution Error has been detected 


(4) 


3 


8 


DDE 


1 a Device Specific Error has occurred 


(5) 


2 


4 


QYE 


1 a QueRy Error has occurred 


(6) 


1 


2 


RQC 


0 The Instrument never requests bus control 


(7) 


0 


1 


OPC 


0 The Operation Complete bit is not used 


(8) 



Standard Event Status Register (ESR) 
Table 5 



Notes: 

(1) The Power On (PON) bit is always turned on (1) when the unit is powered up. 

(2) The User Request (URQ) bit is set true (1 ) when a soft key is pressed. An associated register URR identifies 
which key was selected. For further details refer to the URR? query. 

(3) The CoMmand parser Error bit (CME) is set true (1) whenever a command syntax error is detected. The CME 
bit has an associated CoMmand parser Register (OMR) which specifies the error code. Refer to the query 
CMR? for further details. 

(4) The Execution Error bit (EXE) is set true (1) when a command cannot be executed due to some device 
condition (e.g. oscilloscope in local state) or a semantic error. The EXE bit has an associated Execution Error 
Register (EXR) which specifies the error code. Refer to query EXR? for further details. 

(5) The Device specific Error (DDE) is set true (1) whenever a hardware failure has occurred at power-up or 
execution time such as a channel overload condition , a trigger or a time-base circuit defect . The origin of the 
failure may be localized via the DDR? or the self test *TST? query. 

(6) The Query Error bit (QYE) is set true (1) whenever (a) an attempt is being made to read data from the Output 
Queue when no output is either present or pending, (b) data in the Output Queue has been lost, (c) both 
output and input buffers are full (deadlock state) , (d) an attempt is made by the controller to read before 
having sent an <END>, (e) a command is received before the response to the previous query was read (output 
buffer flushed) . 

(7) The ReQuest Control bit (RQC) is always false (0) since the oscilloscope has no GPIB controlling capability. 

(8) The Operation Complete bit (OPC) is set true (1 ) whenever *OPC has been received since commands and 
queries are strictly executed in sequential order. The oscilloscope starts processing a command only once the 
previous command has been entirely executed. 
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STATUS 



EXR? 

Query 



DESCRIPTION 



QUERY SYNTAX 
Response format 



EXAMPLE (GPIB) 



The EXR? query reads and clears the contents of the Execution 
error Register (EXR) . The EXR register specifies the type of the 
last error detected during execution. Refer to Table 6, page 82 for 
further details. 

EXR? 

EXR <value> 

<value> := 21 to 35 

The following instruction reads the contents of the EXR register. 

CMD$=” *EXR?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message (if no fault) 

EXR 0 



RELATED COMMANDS 



ALL_STATUS?, 



CLS 





Value 


Description 


21 


Permission error. The command cannot be executed in 
local mode. 


22 


Environment error. The instrument is not configured to 
correctly process a command. For instance, the oscilo- 
scope cannot be set to RIS at a slow time base. 


23 


Option error. The command applies to an option which 
has not been installed. 


24 


Unresolved parsing error. 


25 


Parameter error. Too many parameters specified. 


26 


Non-implemented command. 


30 


Hex data error. A non-hexadecimal character has been 
detected in a hex data block. 


31 


Waveform error. The amount of data received does not 
correspond to descriptor indicators. 


32 


Waveform descriptor error. An invalid waveform de- 
scriptor has been detected. 


33 


Waveform time error. Invalid RIS or TRIG time data has 
been detected. 


34 


Waveform data error. Invalid waveform data have been 
detected. 


35 


Panel setup error. An invalid panel setup data block has 
been detected. 



Execution Error Status Register Structure (EXR) 
Table 6 






System Commands ^ 



FUNCTION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 9424 only 



FUNCTION RESET, FRST 

Command 



The FUNCTIONRESET command resets a waveform processing 
function. The number of sweeps will be reset to zero and the proc- 
ess restarted. 

<function> : FunctionReSeT 
<function> := {MC$, MD$, FE, FF} 

Assuming that Function E (FE) has been defined as the summed 
average of Channel 1, the following example will restart the aver- 
aging process. 

CMD$=”FE:FRST”: CALL IBWRT(SCOPE%,CMD$) 

DEFINE, INR? 
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FUNCTION 



DESCRIPTION 



COMMAND SYNTAX 



$ 9424 only 



FUNCnON_STATE, FSTAt 

Command/Query 



The FUN CTI ON_ST ATE command allows the user to control or 
enquire how Functions C, D, E and F are being used. The four 
waveform processing functions may assume up to three different 
states: 

MEM static memory of a waveform (no further automatic pro- 
cessing occurs) 

ZOOM expansion of another waveform (updated as the source 
changes) 

FUNC a mathematical function of one or two other waveforms 
(updated if one of the sources change) 

The two Functions C and D may assume all three states whereas E 
and F may assume only the states MEM and FUNC. The setup 
information needed to execute expansions or mathematical wave- 
form processing is memorized separately by the oscilloscope for 
each function. When the state of a function is changed, the last 
setup information associated with the new state will be reactivated. 

There are three other commands which may cause a state transi- 
tion. The command ZOOM applied to Functions C or D will 
automatically switch them into zoom state. The commands 
STORE (storage from internal waveform) and WAVEFORM 
(storage from external waveform) applied to any one of the Func- 
tions C, D, E or F will automatically switch them into the memory 
state. There is never an automatic transition into the function 
state. The command FUNCTION STATE must be used. 

Initially Functions C and D are set to the memory state and Func- 
tions E and F are set to the function state. 

The query FUNCTION_STATE returns the current state of a 
waveform processing function. 

<function> : Function_STAte <state> 

<function> := {MC, MD, FE, FF} 

<state> := {FUNC, MEM, ZOOM} 



84 



System Commands 

QUERY SYNTAX <function>:Function_STAte? 

Response format <function> : Function_STAte <state> 

EXAMPLE (GPIB) The following example switches the internal function memory C 

into the mathematical waveform processing state thereby re-estab- 
lishing the last valid waveform processing definition. 

CMD$=”MC:FSTA FUNC” : CALL IBWRT(SCOPE%,CMD$) 
RELATED COMMANDS DEFINE, STORE, WAVEFORM, ZOOM 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



$ 9424 only 



GRID 

Command/Query 

f 

- . I 

! 

The GRID command specifies whether the grid should be dis- 
played in single, dual or quad$ mode. 

In single grid mode all the traces are displayed on a single grid. 

In dual grid mode the screen is split into two distinct grids to sepa- 
rate the traces. In the 9420/50, Channel 1 is always displayed in 
the upper grid and Channel 2 in the lower grid. In the 9424, Chan- 
nels 1 and 2 are always displayed in the upper grid and Channels 3 
and 4 in the lower grid. All other waveforms can be vertically posi- 
tioned anywhere. 

I 

In quad grid mode$ Channel 1 is always displayed in the upper 
grid, Channel 2 in the second grid, etc. All other waveforms can 
be vertically positioned anywhere. 

The GRID? query returns the grid mode currently in use. 

GRID <grid> 

<grid> := {SINGLE, DUAL, QUAD*} 

GRID? 

GRID <grid> 

| 

The following command sets the screen display to dual grid mode. 
CMD$=”GRID DUAL”: CALL IBWRT(SCOPE%,CMD$) 
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HARD COPY 



DESCRIPTION 



COMMAND SYNTAX 



HARDCOPYSETUP, HCSU 

Command/Query 



The HARDCOPY SETUP command configures the instrument’s 
hard copy driver. The command enables the user to specify the 
device type, transmission mode, plot size etc. of the hard-copy 
unit connected to the oscilloscope. 

The command allows one or more individual settings to be 
changed by specifying the appropriate keyword (s) together with 
the new value(s). For instance, to select the Graphtec FP5301 
plotter with normal speed, the command may be restricted to: 

HCSU DEV, FP5301, SPEED, N 



Notation 








DEV 


device 


PORT 


port 


SPEED 


plot speed 


DENS 


print density 


PENS 


plot pens 


PFEED 


page feed 


PSIZE 


paper size 


GRID 


grid square 


LLX 


lower left X 


LLY 


lower left Y 


FP5301 


Graphtec FP5301 


PM8151 


Philips PM8151 


HP7470A 


HP 7470A 


HP7550A 


HP 7550A 


HPQJ 


HP QuietJet 


HPTJ 


HP ThinkJet 


HPLJ 


HP LaserJet 


EPSON 


Epson FX80 


N 


Normal 


NS 


Non-standard 


L 


Low 







HardCopy_SetUp DEV,<device>, PORT,<port> 

, SPEED, <plot_speed>, 

DEN S , <print_density>, PENS,<plotjpens>, 
PFEED,<page_feed>, PSIZE,<paper_size>, 

GRID , <grid_square> , LLX,<lower_left_X>, 
LLY,<lower_left_Y> 

Note: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be given in any order and may be restricted 
to those variables to be changed. 
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QUERY SYNTAX 
Response format 



EXAMPLE (GPIB) 



<device> := {FP5301, PM8151, HP7470A, HP7550A, HPQJ, 
HPTJ, HPLJ, EPSON} 

<port> := {GPIB, RS} 

<plot_speed> := (N, L} for plotters only 

<density> := (SINGLE, DOUBLE, QUADRUPLE, 
HIGH_SPEED,HIGH_RESOLUTION, 
ONE_TO_ONE , TWO_TO_ONE,CRT} 

for printers only 

< plot_pens> := 1 to 8 
< P a ge_feed > := {ON, OFF} 

<paper_size> := {A5, A4, A3, NS} 

< grid_square> := 0.0 to 99.9 MM \ 

clower left X>:= -999 to 999 MM > for non-standard 
“ “ I paper size only 

<lower_left_Y> := -999 to 999 MM/ 

Note: For these three parameter values the suffix is optional. 
The suffix M is assumed. 



HardCopy_SetUp? 

HardCopy_SetUp DEV, <device>, PORT, <port>, 

SPEED, <plot_speed>, DENS, <print_density>, PENS, <plot_pens>, 
PFEED,<page_feed>,PSIZE,<paper_size>,GRID,<grid_square>, 
LLX, <lower_left_X> ,LLY, <lower_left_Y > 

This example selects a HP 7550 A plotter to be driven by the GPIB 
port. 

CMD$=”HCSU PORT, GPIB, DEV, HP7550A” 

CALL IBWRT(SCOPE%,CMD$) 



RELATED COMMANDS 



HARDCOPY TRANSMIT, SCREEN DUMP 





System Commands 



HARD COPY 
DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 



RELATED COMMANDS 



HARDCOPY TRANSMIT, HCTR 

Command 



The HARDCOPY TRANSMIT command sends a string of ASCII 
characters without modification to the hard-copy unit. This allows 
the user to control the hard-copy unit by sending device specific 
control character sequences. It also allows the user to place addi- 
tional text on a screen dump for documentation purposes. This 
command accepts the escape sequence “\ddd” like those de- 
scribed under the command COMMJRS232 (see page 56). 
Before sending the string to the hard-copy unit the escape se- 
quence is converted to the ASCII character code. 

HardCopy_TRansmit ’<string>’ 

<string> := Any sequence of ASCII or escaped characters. 

The following code sends documentation data to a printer. 

CMD$=”HCTR ’Data from Oct.l5\r\n”’ 

CALL IB WRT (SCOPE%,CMD$) 

The following code sends the same documentation data to an 
HP7470A plotter using pen 1 . The text will be printed at the lower 
left corner of the paper. 

CMD$= 

"HCTR ’IN ; SP1 ; PAO , 0 ; PD ; LBData from Oct. 15 \03IN;SP0;PA0,0”’ 
CALL IBWRT(SCOPE%,CMD$) 

HARDCOPY_SETUP, SCREEN_DUMP 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



$ 9424 only 



HORJV1AGNIFY, HMAG 

Command/ Query 



The HOR_MAGNIFY command horizontally expands the se- 
lected expansion trace by a specified factor. Magnification factors 
which are not within the range of permissible values will be 
rounded to the closest legal value. 

If multiple zoom is enabled, the magnification factor for all expan- 
sion traces is set to the specified factor. If the specified factor is too 
large for any of the expanded traces (depending on their current 
source) , it is reduced to an acceptable value and only then applied 
to the traces. 

The VAB bit (bit 2) in the STB register (Table 8, page 121 ) is set 
if a factor outside the legal range is specified. 

The HOR__MAGNIFY query returns the current magnification 
factor for the specified expansion function. 

<exp_trace>: Hor_MAGnify <factor> 

<exp_trace> := {EA, EB, MC$, MD$} 

<factor> := 1 to 1000 

<exp_source>:Hor_MAGnify? 

<e xp_ s °ur ce>: H° r _MAGnify <factor> 

The following example horizontally magnifies Expand B (EB) by a 
factor of 5. 

CMD$=”EB:HMAG 5”: CALL IBWRT(SCOPE%,CMD$) 
DUAL ZOOM, ZOOM 
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DISPLAY 



DESCRIPTION 



COMMAND SYNTAX 



$ 9424 only 



HORJPOSITION, HPOS 

Command/Query 



The HOR POSITION command horizontally positions the geo- 
metric center of the intensified zone on the source trace. Allowed 
positions range from division 0 through 10. If the source trace was 
acquired in sequence mode, horizontal shifting will only apply to a 
single segment at a time. 

If the multiple zoom is enabled, the difference between the speci- 
fied and the current horizontal position of the specified trace is 
applied to all expanded traces. If this would cause the horizontal 
position of any expanded trace to go outside the left or right screen 
boundaries, the difference of positions is adapted and then applied 
to the traces. 

If the sources of expanded traces are sequence waveforms, and 
the multiple zoom is enabled, the difference between the specified 
and the current segment of the specified trace is applied to all ex- 
panded traces. If this would cause the segment of any expanded 
trace to go outside of the range of the number of segments of 
sources, the difference is adapted and then applied to the traces. 

The VAB bit (bit 2) in the STB register (Table 8, page 121 ) is set 
if a value outside the legal range is specified. 

The HOR_POSITION query returns the position of the geometric 
center of the intensified zone on the source trace. 

<exp_trace>:Hor _POSition <hor__position> , <segment> 

<exp_trace> := {EA, EB, MC$, MD$} 

<hor__position> := 0 to 10 DIV 
<segment> := 1 to 200 

Note 1: The suffix DIV is optional. 

Note 2: The segment number is only relevant for waveforms ac- 
quired in sequence mode. The segment number is ignored in single 
waveform acquisitions. 
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QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



< exp_trace>:Hor_POSition? 

<exp_trace>:Hor_POSition <hor_position>, [<segment>] 

Note: The segment number is only given for sequence waveforms. 

The following example positions the center of the intensified zone 
on the trace currently viewed by Expand A (EA) at division 3. 

CMD$=” EA:HPOS 3”: CALL IBWRT(SCOPE%,CMD$) 
DUAL ZOOM, ZOOM 
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MISCELLANEOUS 



*IDN? 

Query 



DESCRIPTION 



QUERY SYNTAX 
Response format 



EXAMPLE (GPIB) 



The *IDN? query is used for identification purposes. The response 
consists of four different fields providing information on the manu- 
facturer, the scope model, the serial number and the firmware 
revision level. 

*IDN? 

* IDN LECROY,<model>,<serial_number>,<firmware__level> 
<model> := 5-character model identifier 

<serial_number> := an 8 -digit decimal code (94xxxxxx) 
<firmware_level> := 2 digits giving the release level followed by a 
period and a 1 —digit update level (xx.v) 

This example issues an identification request to the scope. 

CMD$=” *IDN?” : CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 

*IDN LECROY,9450_,94501 153,02.2 
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STATUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



INE 

Command/Query 



The INE command sets the Internal state change Enable register 
(INE) . This command allows one or more events in the INR regis- 
ter to be reflected in the INB summary message bit (bit 0) of the 
STB register. For an overview of the INR defined events refer to 
Table 7, page 95. 

The INE? query reads the contents of the INE register. 

Note: This command can be executed in both local and remote 
modes. 

INE <value> 

<value> := 0 to 65 535 

INE? 

INE <value> 

The following command allows the INB bit to be set whenever a 
screen dump has finished (bit 1, i.e. decimal 2) and/or a waveform 
has been acquired (bit 0, i.e. decimal 1). Summing these two val- 
ues yields the INE mask 2+1=3. 

CMD$=”INE 3”: CALL IBWRT(SCOPE%,CMD$) 

INR? 
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STATUS INR? 

Query 

The INR? query reads and clears the contents of the INternal state 
change Register (INR), The INR register (Table 7) keeps track of 
the completion of various internal operations and state transitions. 

INR? 

INR <state> 

<state> := 0 to 65535 

The following instruction reads the contents of the INR register. 
CMD$=” INR?”: CALL IBWRT(SCOPE%,CMD$) 

Response message: INR 1026 

i.e. waveform processing in Function E and a screen dump have 
both terminated. 



RELATED COMMANDS ALLJSTATUS?, *CLS, INE 



Bit 


Bit Value 


Description 


15. ..12 




0 


Reserved for future use 


11 


2048 


i 


waveform processing has terminated in Function F 


10 


1024 


i 


waveform processing has terminated in Function E 


9 


512 


i 


waveform processing has terminated in Memory D$ 


8 


256 


i 


waveform processing has terminated in Memory C$ 


7. ..4 




0 


Reserved for future use 


3 


8 


1 


a time-out has occurred in a data block transfer 


2 


4 


1 


a return to the local state is detected 


1 


2 


1 


a screen dump has terminated 


0 


1 


1 


a new signal has been acquired 



Internal State Register Structure (INR) 
Table 7 



DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



$ 9424 only, reserved in 9420/50 
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WAVEFORM TRANSFER 



DESCRIPTION 



QUERY SYNTAX 



Response format 



$ 9424 only 



INSPECT?, INSP? 

Query 

The INSPECT? query allows the user to read parts of an acquired 
waveform in intelligible form. The command is based on the expla- 
nation of the format of a waveform given by the template (use the 
query TEMPLATE? to obtain an up-to-date copy) . Each logical 
block of a waveform may be inspected by giving its name (e.g. 
TRIGTIME as mentioned in the template) enclosed in quotes as 
the first (string) parameter. 

The special logical block named WAVEDESC may also be in- 
spected in more detail. By giving the name of a variable in the 
block WAVEDESC enclosed in quotes as the first (string) parame- 
ter, it is possible to inspect only the actual value of that variable. 



Notation 

BYTE: raw data as integers (truncated to 8 m.s.b. * ) 

WORD: raw data as integers (truncated to 16 m.s.b.* ) 

FLOAT: normalized data (gain, offset applied) as floating 

point numbers (gives measured values in volts or 
appropriate units) 

* most significant bits 



<trace>:INSPect? ’<string>’ [,<data_type>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 

<string> := a valid name of a logical block or a valid name 
of a variable contained in block WAVEDESC 
(see the command TEMPLATE and Section 6). 

<data_type> := {BYTE, WORD, FLOAT} 

Note: The optional parameter <data_type> applies only for in- 
specting the data arrays. It selects the representation of the data. 
The default <data type> is FLOAT. 

<trace>:INSPect “<string>” 

<string> := a string giving name(s) and value (s) of a logical block 
or a variable. 
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EXAMPLES (GPIB) 



RELATED COMMANDS 



1) The following command reads the value of the time base at 
which the last waveform in Channel 1 was acquired. 

CMD$:=“C1:INSP? ’TIMEBASE’” 

CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$) : PRINT RSP$ 

Response message 

ClrlNSP “TIMEBASE: 500 US/DIV” 

2) The following command reads the entire contents of the wave- 
form descriptor block. 

CMD$ = “C1:INSP? ’WAVEDESC’” 

TEMPLATE, WAVEFORM SETUP 
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DISPLAY 



INTENSITY, INTS 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The INTENSITY command sets the intensity level of the grid or 
the trace/text provided the local control of the intensity has been 
turned off. Note that normally the screen intensity is still under 
manual control when the oscilloscope operates remotely. The local 
intensity control has to be turned off (using the command INTS 
LOCAL, OFF) before the intensity levels can be modified re- 
motely. 

The intensity level is expressed as a percentage (PCT) . A level of 
100 PCT corresponds to the maximum intensity while a level of 0 
PCT sets the intensity to its minimum value. 

The response to the INTENSITY? query indicates the grid and 
trace intensity levels and their control mode. 

INTenSity LOCAL, <mode>, GRID, <value>, TRACE, <value> 

<mode> := {ON, OFF} 

<value> := 0 to 100 PCT 

Note 1: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be given in any order and may be restricted 
to those variables to be changed. 

Note 2: The suffix PCI' is optional. 

INTenSity? 

INTenSity LOCAL, <mode>, TRACE, <value>, GRID, <value> 

The following instruction enables remote control of the intensity 
and changes the grid intensity level to 75%. 

CMD$=”INTS LOCAL, OFF, GRID, 75” 

CALL IBWRT(SCOPE%,CMD$) 

The following instruction re-enables local control of the intensity. 

CMD$=INTS LOCAL, ON” 

CALL IBWRT(SCOPE%,CMD$) 
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ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE 

RELATED COMMANDS 



INTERLEAVED, ILVD 

Command/Query 



The INTERLEAVED command enables or disables random inter- 
leaved sampling (RIS). RIS is available at time-base settings faster 
than or equal to 5 psec/div (9450) or 20 jxsec/div (9420/24). An 
environment error (Table 6, page 82) will be generated if the user 
attempts to turn off RIS at time-base settings faster than or equal 
to 5 nsec/div (9450) or 20 nsec/div (9420/24), or to turn RIS on 
at time-base settings slower than 5 psec/div (9450) or 20 psec/div 
(9420/24). 

RIS is not available for sequence mode acquisitions and therefore 
an attempt to turn it on in that mode will also result in an environ- 
ment error. 

The response to the INTERLEAVED? query indicates whether 
the oscilloscope is in the RIS mode. 

InterLeaVeD <mode> 

<mode> := {ON, OFF} 

InterLeaVeD? 

InterLeaVeD <mode> 

The following command sets the oscilloscope into RIS mode. 
CMD$ = ”ILVD ON”: CALL IBWRT(SCOPE%,CMD$) 

TIME J3IV, TRIG MODE 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*IST? 

Query 



The *IST? (Individual STatus) query reads the current state of the 
IEEE 488.1 defined “ist” local message. The “ist” individual 
status message is the status bit sent during a parallel poll operation. 

♦1ST? 

♦1ST <value> 

<value> := 0 or 1 

The following command reads the contents of the 1ST bit: 

CMOS = “♦1ST?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD (SCOPE%,RSP$) : PRINT RSP$ 

Response message 
♦1ST 0 

♦PRE 
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DISPLAY 



DESCRIPTION 



KEY 

Command 



The KEY command is used to display a string in the menu field 
next to one of the 9 menu buttons. The string may consist of up to 
12 characters and may be positioned at 4 different locations: 
above (LI), opposite (LC), or below (L2) the menu buttons; or 
(LB) between pairs of buttons, ([1,2], [3,4], [5,6] or [7,8]). See 
Figure 1. 

Note: The button names shown in Figure 1 are not the same as 
those indicated in the front-panel figure at the beginning of the 
Operator’s Manual. 

Texts assigned to the menu buttons will disappear on the next tran- 
sition to local but reappear when the instrument is switched back 
into the remote state. The texts are cleared at power up, when the 
rear-panel RESET button (64) is pressed or if an empty string is 
assigned to a location (e.g. KEY ” ”,L1). 

Pressing any one of the menu buttons while in remote mode causes 
the User Request status Register (URR) and the URQ bit of the 
Event Status Register to be set. This can generate an SRQ provided 
that the service request mechanism has been enabled. 

Note: This command can be executed in both local and remote 
modes. 
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COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



button 1 
button 2 
button 3 
button 4 
button 5 
button 6 
button 7 
button 8 
button 9 




MAIN MENU and RELATED MENU KEYS 
Figure 1 



KEY <button>, ’<string>’ ,<position> 

<button> := 1 to 9 

<string> := a 12 character string (any ASCII code) 
<position> := {LI, LC, L2, LB} 

Note: If the position is omitted, LC will be assumed. 



This example will display the message “Continue” on the upper 
line in the menu field of button 1. 

CMD$=”KEY 1 , ’ CONTINUE’ , L 1 ” 

CALL IBWRT(SCOPE%,CMD$) 

URR? 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



MESSAGE, MSG 

Command/Query 

The MESSAGE command displays a string of characters in the 
Message Field above the grid. The string may be up to 45 charac- 
ters in length. The string is displayed as long as the instrument is in 
remote mode and no internal status message is generated. Turning 
the oscilloscope back to local mode deletes the message. After the 
next transition from local to remote the message will be 
redisplayed. The message is cleared at power up, when the RESET 
button ((64) in the 9420/50, (71) in the 9424) is pressed or if an 
empty string is sent (MSG ” ”)• 

The MESSAGE? query allows the user to read the last message 
which was sent. 



Motei This command can be executed in both local and remote 
modes. 



MeSsaGe ’<string>’ 

<string> := a string of max. 45 characters 



MeSsaGe? 

MeSsaGe ”<string>” 



The following code causes the message ”* Connect Probe 1*” to 
appear in the message field. 

CMD$=”MSG ’* Connect Probe 1*’” 

CALL IBWRT(SCOPE%,CMD$) 



103 





fj) System Commands 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



MULTI ZOOM , MZOM 

Command/Query 



By setting MULTI_ZOOM ON, the horizontal magnification and 
positioning controls apply to all expanded traces simultaneously. 
This command is useful if the contents of all expanded traces are 
to be examined at the same time. 

The MULTI ZOOM? query indicates whether multiple zoom is 
enabled or not. 

Note: This command has the same effect as DUALJZOOM. 

Multi_ZOoM <mode> 

<mode> := {ON, OFF} 

Multi_ZQoM? 

Multi_ZOoM <mode> 

The following example turns the multiple zoom on. 

CMD$=” MZOM ON”: CALL IBWRT(SCOPE%,CMD$) 

HQR_MAGN1FY, HOR_POSITION, DUAL_ZOOM, ZOOM 
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ACQUISITION 



OFFSET, OFST 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
$ 9424 only 



The OFFSET command allows the vertical offset of the specified 
input channel to be adjusted. 

The maximum ranges depend on the fixed sensitivity setting as 
follows: 



Fixed Sensitivity 


Offset Range 


Voltage 


1 V 


dh 10 times 


± 10V 


0.5 V to 20 mV 


± 12 times 


dh 6 V to ± 240 mV 


4 r\ \ / 

IU f T 1 V 


I n a 

m £*+ uriies 


1 n a r\ w 

ZXZ III V 


5 mV 


dh 48 times 


± 240 mV 



If an out-of-range value is entered, the oscilloscope is set to the 
closest possible value and the VAB bit (bit 2) in the STB register is 
set. 

Note: The probe attenuation factor is not taken into account for 
adjusting the offset. 

The OFFSET? query returns the DC offset value of the specified 
channel. 

<channel>:OFfSeT <offset> 

<channel> := {Cl, C2, C3$, C4$} 

<offset> := — 10 V to 10V (maximum range) 

Note: The suffix V is optional. 

<channel>:OFfSeT? 

<channel>:OFfSeT <offset> 

The following command sets the offset of Channel 2 to -3 V. 
CMD$=”C2:OFST -3V”: CALL IBWRT(SCOPE%,CMD$) 
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STATUS 



*OPC 

Command/Query 



DESCRIPTION 


The "OPC (OPeration Complete) command sets the OPC bit (bit 
0) in the standard Event Status Register (ESR) to true. This com- 
mand has no other effect on the operation of the oscilloscope as 
the instrument starts parsing a command or query only after it has 
completely processed the previous command or query. 




The "OPC? query always responds with the ASCII character “1” 
as the oscilloscope responds to the query only once the previous 
command has been entirely executed. 




Note: This command can be executed in both local and remote 
modes. 


COMMAND SYNTAX 


*QPC 


QUERY SYNTAX 


"OPC? 


Response format 


"OPC 1 


RELATED COMMANDS 


"WAI 
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MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



*OPT? 

Query 



The *OPT? query identifies oscilloscope options, i.e. additional 
firmware or hardware options. The response consists of a series of 
response fields listing all the installed options. 

♦ OPT? 

* OPT <option_l>,<option_2>, . . ,<option_N> 

<option_i> := character data 

Note: If no option is present, the character 0 will be returned. 

This example queries the installed options. 

CMD$=”*OPT?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSPS 
Response message 
*OPT 0 

If the waveform processing options WP01 and WP02 are installed, 
the response message is 

♦OPT WP01.WP02 
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SAVE! RECALL SETUP 
DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response syntax 

EXAMPLE (GPIB) 



RELATED COMMANDS 



PANEL _SETUP, PNSU 

Command/Query 



The PANEL SETUP command complements the *SAV/*RST 
commands. The PANEL JSETUP command allows panel setups to 
be archived in encoded form on external storage media. 

Only setup data read by the PNSU? query may be recalled into the 
oscilloscope. A panel setup error (see Table 6, page 82) will be 
generated if the setup data block contains invalid data. 

Note: The communication parameters ( those modified by com- 
mands CFMT, CHDR, CHIP, CORD and WFSU ) and the enable 
registers associated with the status reporting system ( SRE , PRE, 
ESE, INE) are not saved by this command. 

PaNel SetUp <setup> 

<setup> := A setup block previously read by PNSU? 

PaNel_SetUp? 

PaNel_SetUp <setup> 

1. The following instruction saves the instrument’s current panel 
setup in the file PANEL. SET. 

FILES = “PANEL. SET”: CMD$ = “PNSU?” 

CALL IBWRT(SCOPE%,CMD$) 

CALL IBRDF(SCOPE%, FILES) 

2. The following command recalls the front-panel setup stored 
previously in the file PANEL. SET into the oscilloscope. 

CALL IB WRTF(SCOPE%, FILES) 

*RCL, *SAV 



108 



System Commands ^ 



CURSOR 

DESCRIPTION 



QUERY SYNTAX 

Response Format 
t 9424 only 



PARAMETER VALUE?, PAVA? 

Query 



The PARAMETERVALUE? query returns the current value (s) 
of the pulse waveform parameter (s) for the specified trace. Traces 
do not need to be displayed or selected to obtain the values meas- 
ured by the pulse parameters. 

Pulse parameters cannot be evaluated on waveforms composed of 
segments acquired in sequence mode. However pulse parameters 
may be applied to individual segments if they are singled out using 
the expansion function. 



Parameter Names 



FRST 


first point 


LAST 


last point 


PNTS 


points 


MIN 


minimum 


MAX 


maximum 


MEAN 


mean 


SDEV 


std deviation 


RMS 


root mean sq 


DLY 


delay 


PER 


period 


WID 


width 


RISE 


risetime 


FALL 


falltime 


ALL 


all parameters 



Parameter Computation States 

OK deemed to be determined without problem 
AV averaged over several (up to 100) periods 
PT window has been period truncated 
IV invalid value (insufficient data provided) 

NP no pulse waveform 

LT less than given value 

OF signal partially in overflow 

UF signal partially in underflow 

OU signal partially in overflow and underflow 

See the operator’s manual Figure 19. 



<trace>:PArameter_VAlue? [<parameter>, ... <parameter>] 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 
<parameter> := {FRST, LAST, PNTS, MIN, MAX, MEAN, 
SDEV, RMS, DLY, PER, WID, RISE, FALL, ALL} 

<trace>:PArameter__VAlue <parameter>,<value>,<state>[,... 
,<parameter>,<value>,<state>] 
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<value> := decimal numeric value 

<state> := {OK, AV, PT, IV, NP, LT, OF, UF, OU} 

Note: If <parameter> is not specified, or equal to ALL , all the 
parameters followed by their values and states are returned. 

EXAMPLE (GPIB) The following query reads the risetime of Expand B (EB). 

CMD$=”EB:PAVA? RISE”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD (SCOPE%,RD$): PRINT RD$ 

Response message 
”EB:PAVA RISE,3.6E-9S,OK” 

RELATED COMMANDS CURSOR SET 
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STATUS 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*PRE 

Command/Query 



The *PRE command sets the PaRallel poll Enable register (PRE). 
The lowest 8 bits of the Parallel Poll Register (PPR) are composed 
of the STB bits. The *PRE command allows the user to specify 
which bit(s) of the parallel poll register will affect the ’ist’ individ- 
ual status bit. 

The *PRE? query reads the contents of the PRE register. The re- 
sponse is a decimal number which corresponds to the binary sum 
of the register bits. 

Note: This command can be executed in both local and remote 
modes. 

PRE <value> 

<value> := 0 to 65 535 

*PRE? 

*PRE <value> 

The following command will cause the ’ist’ status bit to become 1 
as soon as the MAV bit (bit 4 of STB, i.e. decimal 16) is set. This 
yields the PRE value 16. 

CMD$=” *PRE 16”: CALL IBWRT(SCOPE%,CMD$) 

*IST? 
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SAVE/RECALL SETUP 
DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*RCL 

Command 



The * RCL command sets the state of the instrument using one of 
the eight non-volatile panel setups by recalling the complete 
front-panel setup of the instrument. Panel setup 0 corresponds to 
the default panel setup. 

The *RCL command produces the opposite effect of the *SAV 
command. 

If the desired panel setup is not acceptable, the Execution error 
status Register (EXR) is set and the EXE bit of the standard Event 
Status Register (ESR) is set. 

* RCL <paneljsetup> 

<panel_setup> := 0 to 7 

The following code recalls the instrument setup previously stored 
in panel setup 5 

CMD$=” *RCL 5”: CALL IBWRT(SCOPE%,CMD$) 
PANEL_SETUP, *SAV, EXR? 
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SAVE/RECALL SETUP 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*RST 

command 



The *RST command initiates a device reset. The *RST sets all 8 
traces to the GND line, recalls the default setup and causes a cali- 
bration to be performed. 

*RST 

This example resets the oscilloscope 

CMD$=” *RST” : CALL IBWRT(SCOPE%,CMD$) 

*CAL?, *RCL 
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ACQUISITION 



S AMPLE JCLOCK, SCLK 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response Format 

EXAMPLE 



The SAMPLE CLOCK command allows the user to control the 
use of an external time base. The user sets the number of data 
points that will be acquired when the oscilloscope is using the ex- 
ternal clock. 

Sample_CLocK <state>[,<recordlength>] 

<state> := {INT,EXT} <recordlength> := {50, 100, 200, 500, 

1000, 2000, 5000, 

10000, 20000, 

50000} 

Note: If <recordlength> is not specified the previous value will not 
be modified, ( The parameter <recordlen vth> is initially set to 
50000 )." 

Sample_CLocK? 

Sample__CLocK <state>,<recordlength> 

The following command sets the oscilloscope to use the external 
clock with 1000 data point records. 

CMD$ = “SCLK EXT, 1000”: CALL IBWRT(SCOPE%,CMD$) 
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SAVE/RECALL SETUP 
DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*8AV 

Command 



The * SAV command stores the current state of the instrument in 
non-volatile internal memory. The ’“SAV command stores the 
complete front-panel setup of the instrument at the time the com- 
mand is issued. 

Note: The communication parameters ( those modified by com- 
mands CFMT, CHDR, CHIP, CORD and WFSU) and the enable 
registers associated with the status reporting system (SRE, PRE, 
ESE, INE) are not saved by this command. 

*SAV <panel_setup> 

<panel_setup> := 1 to 7 

The following code saves the current instrument setup in panel 
setup 5. 

CMD$=” *SAV 5”: CALL IBWRT(SCOPE%,CMD$) 
PANEL_SETUP, *RCL 
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HARD COPY 
DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



SCREENDUMP, SCDP 

Command/Query 

The SCREEN DUMP causes the oscilloscope to dump the screen 
contents onto the hard copy device. For plotting, this command 
will not halt oscilloscope activities since plotting is performed in 
parallel with other tasks, unless it is done over the same port as the 
remote control. Printing, however, cannot be done in parallel with 
other oscilloscope operations. 

Screen dumps may be aborted by adding [A] to the screen dump 
command, as shown in the command syntax below. 

The time/date stamp which appears on the plot corresponds to the 
time at which the command was executed. 

The SCREENJDUMP? query indicates whether a screen dump is 
fr\\ T\ ~~ Lor ( C\ CD\ 

wun^iiLij' in pi ugi vji ii aa iihioii^vji a ) . 

SCreen_DumP [A] 

Note: The optional parameter "A" may be used to abort a screen 
dump. 

SCreen_DumP? 

SCreen_DumP <status> 

<status> := {ON, OFF} 

The following code initiates a screen dump. 

CMD$=”SCDP”; CALL IBWRT(SCOPE%,CMD$) 

INR?, HARDCOPY_SETUP, HARDCOPY_TRANSMIT 






116 




System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE 

RELATED COMMANDS 



SEGMENTS, SEGS 

Command/Query 



The SEGMENTS command sets the number of segments for se- 
quence mode acquisition. 

The response to the SEGMENTS? query indicates the number of 
segments which is set in the oscilloscope. 

SEGmentS <segments> 

<segments> := {2, 5, 10, 20, 50, 100, 200} 

SEGmentS? 

SEGmentS <segments> 

The following command sets the segment count to 100. 

CMD$ = ”SEGS 100”: CALL IBWRT(SCOPE%,CMD$) 

TRIG MODE 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 

RELATED COMMANDS 



SELECT, SEL 

Command/ Query 



The SELECT command selects the specified trace for manual dis- 
play control. An environment error (Table 6, page 82) is 
generated if the specified trace is not displayed. 

The SELECT? query returns the selection status of the specified 
trace. 

<trace>:SELect 

<trace> := {EA, EB, MC, MD, FE, FF} 

<trace>:SELect? 

<trace>:SELect <mode> 

<mode> := {ON, OFF} 

The following command selects Expand B (EB). 
CMD$=”EB:SEL”: CALL IBWRT(SCOPE%,CMD$) 

TRACE 
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STATUS 



*SRE 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



The *SRE command sets the Service Request Enable register 
(SRE). This command allows the user to specify which summary 
message bit(s) in the STB register will generate a service request. 
Refer to Table 8, page 121 for an overview of the available sum- 
mary messages. 

A summary message bit is enabled by writing a 1 into the corre- 
sponding bit location. Conversely, writing a 0 into a given bit 
location prevents the associated event from generating a service 
request (SRQ). Clearing the SRE register disables SRQ interrupts. 

The *SRE? query returns a value which when converted to a bi- 
nary number represents the bit settings of the SRE register. Note 

that bit 6 fMSS'i cannot hp spt and its rptnrnpd valup is alwawc 
_ v / -- — — ’ — -* ” 

zero. 

Note: This command can be executed in both local and remote 
modes. 

♦SRE <value> 

<value> := 0 to 255 

♦SRE? 

♦SRE <value> 

The following command allows an SRQ to be generated as soon as 
the MAV summary bit (bit 4, i.e. decimal 16) and/or the INB 
summary bit (bit 0, i.e. decimal 1) in the STB register are set. 
Summing these two values yields the SRE mask 16 + 1 = 17. 

CMD$=” *SRE 17”: CALL 1BWRT(SC0PE%,CMD$) 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*STB? 

Query 



The "STB? query reads the contents of the 488.1 defined status 
register (STB), and the Master Summary Status (MSS). The re- 
sponse represents the values of bits 0 to 5 and 7 of the Status Byte 
register and the MSS summary message. 

The response to a "STB? query is identical to the response of a 
serial poll except that the MSS summary message appears in bit 6 
in place of the RQS message. Refer to Table 8,pagel21 forfurther 
details on the status register structure. 

"STB? 

"STB <vaiue> 

<value> := 0 to 255 

The following instruction reads the status byte register. 

CMD$=” "STB?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 
"STB 0 

ALL_STATUS?, "CLS, "PRE, "SRE 
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■ 


PH 


Name 


Description 




7 


128 


DI07 


0 Reserved for future use 




6 


64 


MSS/RQS 
MSS =1 
RQS =1 


at least 1 bit in STB masked by SRE is 1 
service is requested 


(D 

(2) 


5 


32 


ESB 


1 an ESR enabled event has occurred 


(3) 


4 


16 


MAV 


1 Output queue is not empty 


(4) 


3 


8 


DI03 


0 Reserved 




2 


4 


VAB 


1 a command data value has been adapted 


(5) 


1 


2 


DIOI 


0 Reserved 




0 


1 


INB 


1 an enabled INternal state change 
has occurred. 


(6) 



Status Byte Register (STB) 
Table 8 



Notes: 

(1 ) The Master Summary Status (MSS) indicates that the instrument requests service while the Service Request 
status - when set - specifies that the oscilloscope issued a service request. Bit position 6 depends on the 
polling method: 

Bit 6 = MSS if a *STB? query is received 
= RQS if serial polling is conducted 

(2) Example: If SRE = 10 and STB = 10 then MSS = 1 . If SRE = 010 and STB = 100 then MSS=0. 

(3) The Event Status Bit (ESB) indicates whether or not one or more of the enabled IEEE 488.2 events have 
occurred since the last reading or clearing of the Standard Event Status Register (ESR). ESB is set if an 
enabled event becomes true (1). 

(4) The Message Available bit (MAV) indicates whether or not the Output queue is empty. The MAV summary bit 
is set true (1) whenever a data byte resides in the Output queue. 

(5) The Value Adapted Bit (VAB) is set true (1 ) whenever a data value in a command has been adapted to the 
nearest legal value , For instance , the VAB bit would be set if the time base is redefined as 2 . 5 jisec/div since 
the adapted value is 2 jisec/div. 

(6) The INternal state Bit (INB) is set true (1 ) whenever certain enabled internal states are entered. For further 
information, refer to the INR? query. 
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System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 

RELATED COMMANDS 



STOP 

Command 



The STOP command immediately stops the acquisition of a signal. 
It changes the acquisition state from “ready” to “triggered”, and if 
the trigger mode is AUTO or NORM it will change to trigger mode 
SINGLE to prevent further acquisition. 

STOP 

The following command stops the acquisition process. 

CMD$ = ’’STOP”: CALL IBWRT(SCOPE%,CMD$) 

ARM_ACQUISITION, TRIG_MODE, WAIT 
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System Commands 



WAVEFORM TRANSFER 



DESCRIPTION 



COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 9424 only 



STORE, STO 

Command 



The STORE command stores the contents of the specified trace 
into one of the internal function memories, Memory C, 
Memory D, Function E$ or Function F$. 

<memory> STOre <trace> 

<memory> := {MC, MD, FE$, FF$} 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 



The following command stores the contents of Expand B (EB) into 
Memory D (MD). 

CMD$=”MD:STO EB”: CALL IBWRT(SCOPE%,CMD$) 
FUNCTION_STATE$ 
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System Commands 



WAVEFORM TRANSFER 
DESCRIPTION 

QUERY SYNTAX 
Response format 

RELATED COMMANDS 



TEMPLATE?, TMPL? 

Query 



The TEMPLATE? query produces a copy of the template which 
formally describes the various logical entities making up a com- 
plete waveform. In particular, the template describes in full detail 
the variables contained in the descriptor part of a waveform. Refer 
to Section 6 for further information. 

TeMPLate? 

TeMPLate “<template>” 

<template> := A variable length string detailing the structure of 
a waveform. 

INSPECT? 
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System Commands 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TIMEJDIV, TDIV 

Command/Query 



The TIME_DIV command modifies the time-base setting. The 
new time-base setting may be specified with suffixes NS for 
nanoseconds, US for microseconds, MS for milliseconds, S for 
seconds or KS for kiloseconds. An out-of-range value causes the 
VAB bit (bit 2) in the STB register (Table 8, STB) to be set. 

The oscilloscope will force random interleaved sampling (RIS) for 
time-base settings faster than or equal to 5 nsec/div (9450) or 
20 nsec/div (9420/24) and single-shot sampling for time-base set- 
tings slower than or equal to 10 psec/div (9450) or 50 psec/div 
(9420/24). Within this range the INTERLEAVED command al- 
lows the user to choose the required sampling mode. 

Sequence mode acquisitions also force single-shot sampling and 
are therefore restricted to time-base values slower than or equal to 
10 nsec/div (9450) or 50 nsec/div (9420/24). In sequence mode 
an environment error (Table 6, page 82) will be generated if the 
user attempts to set the time base to a faster value. 

The TIME_DIV? query returns the current time-base setting. 

Time_DIV <value> 

<value> := 1 NS to 5 KS 

Note: The suffix S ( seconds ) is optional. 

Time_DIV? 

TimeJDIV <value> 

The following command sets the time base to 500 psec/div. 
CMD$=”TDIV 500US” : CALL IBWRT(SCOPE%,CMD$) 

The following command sets the time base to 2 msec/div. 
CMD$=”TDIV.002” : CALL IBWRT(SCOPE%,CMD$) 

INTERLEAVED, TRIG DELAY, TRIG MODE 
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System Commands 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



$ 9424 only 



TRACE, TRA 

Command/Query 



The TRACE command enables or disables the display of a trace. 
An environment error (Table 6, page 82) is set if an attempt is 
made to display more than four waveforms. 

The TRACE? query indicates whether the specified trace is dis- 
played or not. 

<trace>:TRAce <mode> 

<trace> := {Cl, C2, C3$, C4$, EA, EB, MC, MD, FE, FF} 
<mode> := (ON, OFF} 



<trace>:TRAce? 

<trace>:TRAce <mode> 

The following command displays Function E (FE). 
CMD$=”FE:TRA ON”: CALL IBWRT(SCOPE%,CMD$) 
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System Commands 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*TRG 

Command 



The *TRG command executes an ARM command. 

Note: The *TRG command is the equivalent of the 488.1 GET 
( Group Execute Trigger ) message. 

*TRG 

The following command enables signal acquisition. 

CMD$=” *TRG”: CALL IBWRT(SCOPE%,CMD$) 

ARM_ ACQUISITION, STOP, WAIT 
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System Commands 



ACQUISITION 



TRIG COUPLING, TRCP 

Command/ Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 



The TRIG_COUPLING command sets the coupling mode of the 
specified trigger source. The trigger slope is automatically changed 
to positive when the trigger coupling is set to HFDIV. 

Note: HFDIV is indicated as HF on the front panel . See the Oper- 
ator’s Manual, Section 5 (9424) or Section 6 (9450/20). 

The TRIG_COUPLING? query returns the trigger coupling of the 
selected source. 

<trig_source> : TRig_CouPling <trig_coupling> 

<trig_source> := {Cl, C2, EXt & , EXIOt, C4$} 

<trig_coupling> := {AC, DC, HFREJ, LFREJ, HFDIV} 

<trig_source> : TRig_CouPling? 

< trig_source >: TRig_CouPling <trig_coupling> 



EXAMPLE (GPIB) The following command sets the coupling mode of the trigger 

source Channel 2 to high frequency reject. 

CMD$=”C2:TRCP HFREJ”: CALL IBWRT(SCOPE%,CMD$) 



RELATED COMMANDS TRIG SELECT 



$ standard 9424 only, f 9420/50 only, & 9424 with ext. trigger option 
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System Commands 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRIGJDELAY, TRDL 

Command/Query 

The TRIG_DELAY command sets the time at which the trigger is 
to occur with respect to the first acquired data point (displayed at 
the left hand edge of the screen). 

The command expects positive trigger delays to be expressed as a 
percentage of the full horizontal screen (this mode is called pre- 
trigger acquisition as data are acquired before the trigger occurs) . 
Negative trigger delays must be given in seconds (this mode is 
called post-trigger acquisition as the data are acquired after the 
trigger has occurred). 

If a value outside the range -10 000 div X time/div and 100% is 
specified, the trigger time will be set to the nearest limit and the 
VAB bit (bit 2) will be set in the STB register. 

The response to the TRIG_DELAY? query indicates the trigger 
time with respect to the first acquired data point. Positive times are 
expressed as a percentage of the full horizontal screen and nega- 
tive times in seconds. 

TRig_DeLay <value> 

<value> := 0.00 PCT to 100.00 PCT (pretrigger) 

-20 PS to -50 MAS (post-trigger) 

Note: The suffix is optional. For positive numbers the suffix PCT 
is assumed. For negative numbers the suffix S is assumed. MAS is 
the suffix for Msec (megaseconds) , useful only for extremely large 
delays at very slow time bases. 

TRig_DeLay? 

TRig_DeLay <value> 

The following command sets the trigger delay to - 20 sec (post- 
trigger) 

CMD$=”TRDL -20S” : CALL IBWRT(SCOPE%,CMD$) 

TIME DIV 
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System Commands 



ACQUISITION 



TRIG_LEVEL, TRLV 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 



The TRIG_LEVEL command adjusts the trigger level of the speci- 
fied trigger source- An out-of-range value will be adjusted to the 
closest legal value and will cause the VAB bit (bit 2) in the STB 
register (Table 8, page 121 ) to be set. 

The range of values is as follows: 

± 5 times the total V/div setting - with CHAN 1 or CHAN 2 as 
the trigger source 

± 2 V with EXT as trigger source for 9420 and 9450 
dh 0.8 V with EXT as trigger source for 9424 with ext. trigger 
option 

zh 20 V with EXT/ 10 as trigger source 

The TRIG_LEVEL? query returns the current trigger level. 

<trig_source>:TRig_LeVel <trig_level> 

<trig_source> := {Cl, C2, EXf & , EXIOt, C4$} 

< trig_le ve l > := -20V to 20V (maximum range) 

Note : The suffix V is optional. 

<trig_source>:TRig_LeVel? 

<trig_source> : TRigJLeVel <trig_level> 



EXAMPLE (GPIB) The following command adjusts the trigger level of Channel 2 to 

-3.4 V. 

CMD$=”C2:TRLV -3.4V”: CALL IBWRT(SCOPE%,CMD$) 



RELATED COMMANDS TRIG SELECT 



$ standard 9424 only, t 9420/50 only, & 9424 with ext. trigger option 
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System Commands 



ACQUISITION 



TRIGJMODE, TRMD 

Command/ Query 



DESCRIPTION 



COMMAND SYNTAX 



The TRIG_MODE command specifies the trigger mode. An envi- 
ronment error (Table 6, page 82) will be generated when TRMD 
SEQNCE is received while the instrument is in the interleaved 
sampling (RIS) acquisition mode. With the mode SINGLE, this 
command will not arm the trigger. Use the command ARM_AC- 
QUISITION to actually start a single acquisition. 

The TRIG_MODE? query returns the current trigger mode. 
TRig_MoDe <mode> 

<mode> := {AUTO, NORM, SEQNCE, SINGLE, WRAP} 



nnr» • _ -& k _ y-^ _ n 

i viui-/e i 



Response format 



EXAMPLE (GPIB) 



RELATED COMMANDS 



TRig_MoDe <mode> 

The following command selects the sequence mode. 
CMD$=”TRMD SEQNCE”: CALL IBWRT(SCOPE%,CMD$) 

ARM ACQUISITION, STOP, TRIG SELECT 
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System Commands 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRIG_PATTERN, TRPA 

(9420/50 and 9424 with ext. trigger option) 

Command/Query 

The TRIG_PATTERN command defines a trigger pattern. The 
command specifies the logic composition of the pattern sources 
(Channel 1, Channel 2, External) and the conditions under which 
a trigger can occur. Note that this command can be used even if 
the complex trigger mode has not been activated. 



Notation 




L 


Low 




H 


High 




X 


Don’t Care 




PR 


pattern present 


AB pattern absent 


EN 


pattern entered 


EX pattern exited 



The TRIG_PATTERN? query returns the current trigger pattern. 

TRig_PAttern <C l_state>,<C2_state>,<EX_state>,<trig_condi- 
tion> 

<Ci_state> := {L,H,X} 

<C2_state> := {L,H,X} 

<EX_state> := {L,H,X} 

< t r ig_ c onditi on> := {PR, AB, EN, EX} 

TRigJPAttern? 

TRig_PAttern <Cl_state>,<C2_state>,<EX_state>,<trig_condi- 
tion> 



The following command configures the logic state of the pattern as 
HLX (CHI = H, CH2 = L, EX = X) and defines the trigger con- 
dition as pattern absent (AB). 

CMD$=”TRPA H,L,X,AB”: CALL IBWRT(SCOPE%,CMD$) 
TRIG SELECT 
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System Commands 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TMGJPATTERN, TRPA (9424) 

Command/Query 



The TRIGPATTERN command defines a trigger pattern. The 
command specifies the logic composition of the pattern sources 
(Channel 1, Channel 2, and Channel 4) and the conditions under 
which a trigger can occur. Note that this command can be used 
even if the complex trigger mode has not been activated. 



Notation 






L 


Low 






H 


High 






X 


Don’t Care 






PR 


pattern present 


AB 


pattern absent 


EN 


pattern entered 


EX 


pattern exited 



The TRIG_PATTERN? query returns the current trigger pattern. 

TRig_PAttern <C l_state>,<C2_state>,<C4_state>,<trig_condi- 
tion> 

<Cl_state> := {L,H,X} 

<C2_state> := {L,H,X} 

<C4_state> := {L,H,X} 

<trig_condition> := {PR, AB, EN, EX} 

TRig__PAttern? 

TRigJPAttern <Cl__state>,<C2_state>,<C4_state>,<trig_condi- 
tion> 

The following command configures the logic state of the pattern as 
HLX (CHI = H, CH2 = L, CH4 = X) and defines the trigger con- 
dition as pattern absent (AB). 

CMD$=”TRPA H,L,X,AB”: CALL IBWRT(SCOPE%,CMD$) 
TRIG SELECT 
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£) System Commands 



ACQUISITION 



DESCRIPTION 



COMMAND SYNTAX 



TRIGJSELECT, TRSE (9420/50) 

Command/Query 



The TRIG_SELECT command selects the condition that will trig- 
ger the acquisition of waveforms. Depending on the trigger type, 
additional parameters have to be specified. 

The additional parameters are grouped in pairs. The first one 
names the variable to be modified and the second one gives the 
new value to be assigned. Pairs may be given in any order and may 
be restricted to those variables to be changed. 

Note: The state-qualified, time /event qualified and pattern trigger 
types use the trigger pattern defined by the command TRIG- 
GER_PA TTERN. 

The TRIG_SELECT? query returns the current trigger condition. 



Trigger Notation 



STD 


Standard 


SNG 


Single source 


PA 


Pattern 


SQ 


State qualified 


TEQ 


Time event qualified 


TI 


Time 


PL 


Pulse larger 


IL 


Interval larger 


EV 


Event 


PS 


Pulse smaller 


IS 


Interval smaller 


SR 


Source 


HT 


Hold type 


HV 


Hold value 


TV Trigger Notation 






FLD 


Field 


FLDC 


Field Count 


LINE 


Line 


CHAR 


Characteristics 


LPIC 


Lines per picture 


ILAC 


Interlace 



SR does not apply to the Pattern trigger. 

HT and HV do not apply to the standard trigger. 



TRigjSElect <trig_type>,SR,<source>,HT,<hold_type>, 

HV,<hold_value> 

<trig_type> := {STD, SNG, SQ, TEQ, PA} 

<source> := {Cl, C2, LINE, EX, EX10} 

<hold__type> := {TI, EV, PS, PL, IS, IL} 

<hold_value> := 25NS to 20S for TI 
1 to 10 9 for EV 
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System Commands 



COMMAND SYNTAX 
TV TRIGGER 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 

EXAMPLE: TV 
RELATED COMMANDS 

@ for CUST50 and CUST60 only, 



2.5NS to 20S for PS and PL* 

IONS to 20S for IS* 

25NS to 20S for IL* 

* these values are only valid for single-source and pattern triggers. 
Note: The suffix S ( seconds ) is optional. 



TRig_S Elect TV, SR, EX , FLDC ,<field_count>, FLD , <field>, 

CHAR, <characteristics>, LPIC@ > <lpic>, IL AC@ , <ila ce>, 
LINE,<line> LINE,<line> 

<field_count> := {1, 2, 4, 8} 

<field> := 1 to field_count 

<characteristics> := { NTSC,PALSFC,CUST50 & ,CUST60 & } 
<lpic> := 1 to 1500 
<ilace> := {1, 2, 4, 8} 

<line> := 1 to 1500 

Note: The FLD value is interpreted with the current FLDC value. 
The LINE value is interpreted with the current FLD and CHAR 
values. 

TRig_SElect? 

TRig_SElect <trig_type>,SR,<source>,HT,<hold_type>, 
HV,<hold_value> 

TRig_SElect TV,SR,EX,FLDC,<fieid_count>,FLD,<field>, 
CHAR,<characteristic>,LINE,<line> 

The following command selects the single-source trigger with 
Channel 1 as trigger source. Hold type and hold value are chosen 
as “Pulse smaller” than 20 jisec 

CMD$=”TRSE SNG,SR,C1,HT,PS,HV,20 US” 

CALL IBWRT(SCOPE%,CMD$) 

CMD$ = ”TRSE TV, SR, EX, FLDC, 8, FLD, 3, CHAR, 
PALSEC.LINE, 17” 



TRIG_COUPLING, TRIG_LEVEL, TRIG MODE, TRIGJPAT- 
TERN, TRIG_SLOPE 



& for oscilloscopes with HDTV hardware option only 
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System Commands 



ACQUISITION 



DESCRIPTION 



COMMAND SYNTAX 



$ standard 9424 only, & 



TRIG SELECT, TRSE (9424) 

Command/Query 



The TRIGJSELECT command selects the condition that will trig- 
ger the acquisition of waveforms. Depending on the trigger type, 
additional parameters have to be specified. 

The additional parameters are grouped in pairs. The first one 
names the variable to be modified and the second one gives the 
new value to be assigned. Pairs may be given in any order and may 
be restricted to those variables to be changed. 

Note: The state-qualified, time /event qualified and pattern trigger 
types use the trigger pattern defined by the command TRIG- 
GER JPATTERN. 

The TRIG_SELECT? query returns the current trigger condition. 



Trigger Notation 



STD 


Standard 


SNG 


Single source 


PA 


Pattern 


SQ 


State qualified 


TEQ 


Time event qualified 


TI 


Time 


PL 


Pulse larger 


IL 


Interval larger 


EV 


Event 


PS 


Pulse smaller 


IS 


Interval smaller 


SR 


Source 


HT 


Hold type 


HV 


Hold value 


TV Trigger Notation 






FLD 


Field 


FLDC 


Field Count 


LINE 


Line 


CHAR 


Characteristics 


LPIC 


Lines per picture 


ILAC 


Interlace 



SR does not apply to the Pattern trigger. 

HT and HV do not apply to the standard trigger. 



TRig_S Elect <trig_type>,SR,<source>,HT,<hold_type>, 

HV,<hold_value> 

<trig_type> := {STD, SNG, SQ, TEQ, PA} 

<source> := {Cl, C2, LINE, EX & , C4$} 

<hold_type> := {TI, EV, PS, PL, IS, IL} 

<hold_value> := 25NS to 20S for TI 
1 to 10 9 for EV 

9424 with ext. trigger option only 
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System Commands 



COMMAND SYNTAX 
TV TRIGGER 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 

EXAMPLE: TV 
RELATED COMMANDS 

® for CUST50 and CUST60 only, 



2.5NS to 20S for PS and PL* 

IONS to 20 S for IS* 

25NS to 20S for IL* 

* these values are only valid for single-source and pattern triggers. 
Note: The suffix S (seconds) is optional. 



TRig_SElect TV,SR,C3,FLDC,<field_count>,FLD,<field>, 

CHAR,<characteristics>,LPIC@*<lpic>,ILAC@,<ilace>, 

LINE,<line> 

<field_count> := {1, 2, 4, 8} 

<field> := 1 to field_count 

<characteristics> := { NTSC,PALSEC,CUST50 & ,CUST60 & } 
<lpic> := 1 to 1500 
<ilace> := {1, 2, 4, 8} 

<line> := 1 to 1500 

Note: The FLD value is interpreted with the current FLDC value. 
The LINE value is interpreted with the current FLD and CHAR 
values. 

TRig_SElect? 

TRig_SElect <trig_type>,SR,<source>,HT,<hold_type>, 
HV,<hold_value> 

TRig_SElect TV,SR,C3,FLDC,<field_count>,FLD,<field>, 
CHAR, <characteristic>, LINE, <line> 

The following command selects the single-source trigger with 
Channel 1 as trigger source. Hold type and hold value are chosen 
as “Pulse smaller” than 20 psec 

CMD$=”TRSE SNG,SR,C1,HT,PS,HV,20 US” 

CALL IBWRT(SCOPE%,CMD$) 



CMD$ = ”TRSE TV, SR, C3, FLDC, 8, FLD, 3, CHAR, 
PALSEC.LINE, 17” 



TRIG COUPLING, TRIG_LEVEL, TRIG MODE, TRIGJPAT- 
TERN, TRIG SLOPE 



& for oscilloscopes with HDTV hardware option only 
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System Commands 



ACQUISITION 



TRIG SLOPE, TRSL 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 



The TRIG_SLOPE command sets the trigger slope of the specified 
trigger source. An environment error (see Table 6, page 82) will 
be generated when TRSL NEG is received while the trigger cou- 
pling is set to HFDIV (see TRIG„COUPLING) . 

The TRIG_SLOPE? query returns the trigger slope of the selected 
source. 

< trig__source >: TRig_SLope <trig_slope> 

<trig_source> := {Cl, C2, EX| & , EXIOt, C4$} 

< trig_slope> := {NEG, POS} 

<trig_source> : TRig_S Lope ? 

<trig_source>:TRig_SLope <trig_slope> 



EXAMPLE (GPIB) The following command sets the trigger slope of Channel 2 to 

negative . 

CMD$=”C2:TRSL NEG”: CALL IBWRT(SCOPE%,CMD$) 
RELATED COMMANDS TRIG SELECT 



$ standard 9424 only, 



t 9420/50 only, & 9424 with ext. trigger option 
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System Commands 



MISCELLANEOUS 

DESCRIPTION 
QUERY SYNTAX 

Pocaahoiq IT'ArmQf 

n. uiun 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*TST? 

Query 



The *TST? query performs an internal self-test. The response in- 
dicates if the self-test detected any errors. The self-test includes 
testing the hardware of all channels, the time base and the trigger 
circuits. 

Hardware failures are identified by a unique binary code in the 
returned <status> number (see Table 1, page 46). A “0” response 
indicates that no failures occurred. 

Note: This query is only accepted in remote mode. 

*TST? 



<status>:= 0 self-test successful 

This example causes a self-test to be performed. 

CMD$=” *TST?”: CALL IBWRT(SCOPE%,CMD$) 
CALL IBRD(SCOPE%,RD$): PRINT RD$ 

Response message (if no failure) 

*TST 0 

*CAL? 
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System Commands 



STATUS 

DESCRIPTION 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



URR? 

Query 



The URR? query reads and clears the contents of the User Request 
status Register (URR) . The URR register specifies which button in 
the menu field was pressed. Refer to Table 9 for further details. 

In the remote mode, the URR register indicates the last button 
(2 ... 10) which was pressed. In local mode, the URR register indi- 
cates whether the CALL HOST button has been pressed. If no 
menu button has been pressed since the last URR? query, the 
value 0 is returned. Figure 1, (page NO TAG) shows the button 
assignments on the instrument. 

URR? 

URR <value> 

<value> := 0 to 9, 100 

The following instruction reads the contents of the URR register. 

CMD$=”URR?”: CALL IBWRT(SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RSP$): PRINT RSP$ 

Response message 
URR 0 



CALL_HOST, KEY, ALL_STATU S ? , *CLS 



Value 


Description 


0 


no button has been pressed 


i 


button 1 has been pressed. 


2 


button 2 has been pressed. 


3 


button 3 has been pressed. 


4 


button 4 has been pressed. 


5 


button 5 has been pressed. 


6 


button 6 has been pressed. 


7 


button 7 has been pressed. 


8 


button 8 has been pressed. 


9 


button 9 has been pressed. 


100 


The “Call Host” key (button 10 
in root menu) has been pressed. 



User Request Status Register Structure (URR) 
Table 9 
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System Commands ^ 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



VERTJV1AGNIFY, VMAG 

Command/Query 



The VERT_MAGNIFY command vertically expands the specified 
trace. The command is executed even if the trace is not displayed. 

The VERT_MAGNIFY? query returns the magnification factor of 
the specified trace. 

<trace>:Vert_MAGnify <factor> 

<trace> := (EA, EB, MC, MD, FE, FF} 

<factor> := 0.2 to 5.0 (10.0 for high resolution data) 

<trace> : Vert_M AGnify ? 

<trace>:Vert_MAGnify <factor> 

The following command enlarges the vertical amplitude of Func- 
tion E by a factor of 3.45 with respect to its original amplitude. 

CMD$=”FE:VMAG 3.45”: CALL IBWRT(SCOPE%,CMD$) 
VERT POSITION 
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System Commands 



DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



VERT_POSITTON, VPOS 

Command/ Query 



The VERT POSITION command adjusts the vertical position of 
the specified trace on the screen. The VERTPOSITION com- 
mand does not affect the original offset value obtained at 
acquisition time. 

The VERTJPQSmON? query returns the current vertical posi- 
tion of the specified trace. 

<trace>:Vert_POSition <display_offset> 

<trace> := {EA, EB, MC, MD, FE, FF} 

<display_offset> := -56 DIV to 56 DIV 

Note: The suffix DIV is optional. 

<trace>:Vert_POSition? 

<trace>:Vert_POSition <display_offset> 

The following command shifts Expand A (EA) upwards by +3 divi- 
sions, relative to the position at the time of acquisition. 

CMD$=”EA:VPOS 3DIV”: CALL IBWRT(SCOPE%,CMD$) 
VERT MAGNIFY 
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System Commands 



ACQUISITION 



VOLTJDIV, VDIV 

Command/Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



The VOLT DIV command sets the vertical sensitivity in Volts/di v. 
Values ranging between 5.0 mV and 2.5 V can be specified. The 
VAB bit (bit 2) in the STB register (Table 8, page 121 ) is set if an 
out-of-range value is entered. 

Note: The probe attenuation factor is not taken into account for 
adjusting vertical sensitivity. 

The VOLT_DIV? query returns the vertical sensitivity of the speci- 
fied channel. 

<channel>:Volt_DIV <v_gain> 

<channel> := (Cl, C2, C3±, C4±} 

<v_gain> := 5.0 mV to 2.5 V 
Note: The suffix V is optional. 

<channel> : Volt_DI V? 

<channel>:Volt_DIV <v_gain> 

The following command sets the vertical sensitivity of channel 1 to 
50 mV/div. 

CMD$=”C1:VDIV 50MV”: 

CALL IBWRT(SCOPE%,CMD$) 



$ 9424 only 
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STATUS 

DESCRIPTION 



Command syntax 
RELATED COMMANDS 



*WAI 

Command 



The *WAI (WAIt to continue) command, required by the IEEE 
488.2 standard, has no effect on the oscilloscope as the oscillo- 
scope only starts processing a command when the previous 
command has been entirely executed. 

Note: This command can be executed in both local and remote 
modes. 

* WAI 
*OPC 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 



WAIT 

Command 



The WAIT command prevents the instrument from analyzing new 
commands until the oscilloscope has completed the current acqui- 
sition process. 

WAIT 

send: ”TRMD SINGLE” 
loop {send: ”ARM; WAIT;C1:PAVA? MAX” 
read response 
process response 



This example finds the maximum amplitudes of several signals ac- 
quired one after another. ARM starts a new data acquisition. The 
WAIT command ensures that the maximum is evaluated for the 
newly acquired waveform. 

”C1:PAVA? MAX” instructs the instrument to evaluate the maxi- 
mum data value in the channel 1 waveform. 



145 



System Commands 



WAVEFORM TRANSFER 
DESCRIPTION 



COMMAND SYNTAX 
QUERY SYNTAX 



Response format 
$ 9424 only 



WAVEFORM, WF 

Command/Query 



A WAVEFORM? query transfers a waveform from the oscillo- 
scope to the controller, whereas a WAVEFORM command 
transfers a waveform from the controller to the oscilloscope. 

The WAVEFORM command stores an external waveform back 
into the oscilloscope’s internal memory. A waveform consists of 
several distinct entities: 

(1) the descriptor (DESC), 

(2) the user text (TEXT), 

(3) the time (TIME) descriptor, 

(4) the data (DAT1) block, and optionally 

(5) a second block of data (DAT2). 

For further information on the structure of the waveform refer to 
Section 6. In the 9424 the WAVEFORM command automatically 
sets the corresponding function to the memory state. 

Note: Only complete waveforms queried with ” WAVEFORM ? 
ALL” can he restored into the oscilloscope. 

The WAVEFORM? query instructs the oscilloscope to transmit a 
waveform to the controller. The entities may be queried independ- 
ently. If the “ALL” parameter is specified, all 4 or 5 entities are 
transmitted in one block in the order enumerated above. 

Note: The format of the waveform data depends on the current 
settings specified by the last WA VEFORM_SE TUP command, the 
last COMMjORDER command and the last COMM _F ORMAT 
command. 

<memory>:WaveForm ALL,<waveform_data_block> 

<memory>:= {MC, MD, FE$, FF$} 

<waveform_data_block> := arbitrary data block 

<trace>:WaveForm? <block> 

<trace>:= {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4J} 
<block>:= {DESC, TEXT, TIME, DAT1, DAT2, ALL} 

Note: If no parameter is given ALL will be assumed. 

<trace>:WaveForm <block>,<waveform_data_block> 
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Note: It may be convenient to disable the response header if the 
waveform is to be restored. Refer to command COMM_HEA DER 
for further details. 



EXAMPLE (GPIB) 1) The following command reads the block DAT1 from Memory C 

and saves it in the file “MEMC.DAT” . The path header “MC:” 
is saved together with the data. 

FILES = “MEMC.DAT” 

CMOS = “MC:WF? DAT1” 

CALL IB WRT (SCOPE%,CMD$) 

CALL IBRDF(SCOPE%, FILES) 

2) In the following example, the entire contents of Channel 1 are 
saved in the file “CHAN1.DAT”. The path header “Cl:” is 
skipped to ensure that the data can later be recalled into the 
oscilloscope. 

FILES = “ CHAN 1 .DAT” :RD$=SPACE$ (3) 

riAiTTMf Iirirrrvn ounrcn ^ t rr^n >1 

anuRi; u:wr/ 

CALL IB WRT (SCOPE%,CMD$) 

CALL IBRD(SCOPE%,RD$) Skip first 3 characters “Cl:” 
CALL IBRDF(SCOPE%, FILES) Save data in the file 

“CHAN1.DAT” 

3) The following example illustrates how the waveform data saved 
in example 2) can be recalled into Memory C. 

FILES = “CHAN1.DAT” 

CMDS = MC:TRACE ON” 

CALL IBWRT(SCOPE%,CMD$) 

CALL IBWRTF(SCOPE%, FILES) 

The MC:TRACE ON command ensures that the <trace> is set 
to “MC”. When the data file is sent to the instrument, it first 
sees the header “WF” (the characters “Cl:” having been 
skipped when reading the file) and assumes the default destina- 
tion “MC”. 

RELATED COMMANDS INSPECT?, COMM_FORMAT, COMM-ORDER, FUNC- 

TION_STATE$, TEMPLATE?, WAVEFORM_SETUP, 
WAVEFORM_TEXT, 



$ 9424 only 
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WAVEFORM TRANSFER 



WAVEFORM SETUP, WFSU 

Command/Query 



DESCRIPTION 



The WAVEFORM_SETUP command specifies the amount of 
data in a waveform which will be transmitted to the controller. The 
command controls the settings of the following parameters: 

a. Sparsing (SP). The sparsing parameter defines the interval 
(0.. 25000) between data points. For example: 



SP = 0 reads all data points 
SP = 1 reads all data points 
SP = 4 reads every 4th data point 

b. Number of points (NP). The number of points parameter 
indicates how many points should be transmitted. For ex- 
ample: 



NP = 0 sends all data points 
NP = 1 sends 1 data point 
NP = 5 sends a maximum of 5 data points 
NP =10 sends a maximum of 10 data points 
NP = 50 000 sends a maximum of 50 000 data 
points 

c. First point (FP). The first point parameter specifies the 
address of the first data point to be sent. For waveforms 
acquired in sequence mode, this refers to the relative ad- 
dress in the given segment. For example: 

FP = 0 corresponds to the first data point 
FP = 1 corresponds to the second data point 
FP = 5000 corresponds to data point 5001 

d. Segment number (SN). The segment number parameter (0 
to 200) indicates which segment should be sent if the 
waveform was acquired in sequence mode. This parameter 
is ignored for non-segmented waveforms. For example: 



SN = 0 all segments 
SN = 1 first segment 
SN = 23 segment 23 

The WAVEFORM_SETUP? query returns the transfer parame- 
ters currently in use. 



Notation 




SP 


sparsing 


NP number of points 


FP 


first point 


SN segment number 
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COMMAND SYNTAX 



QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



WaveForm_SetUp SP,<sparsing>,NP,<number>,FP,<point>, 
SN,<segment> 

<sparsing> := 0 to 25000 (0 = no sparsing) 

<number> := 0 to 50000 (0 = all data points) 

<point> := 0 to 50000 

<segment> := 0 to 200 (0 = all segments) 

Note 1: After power-on, all values are set to 0 (i.e. entire wave- 
forms will be transmitted without sparsing). 

Note 2: Parameters are grouped in pairs. The first one names the 
variable to be modified and the second one gives the new value to 
be assigned. Pairs may be given in any order and may be restricted 
to those variables to be changed. 

WaveForm_SetUp? 

WaveForm_Setu T p SP,<sparsing>, NP,<number>, 

FP,<point>, SN,<segment> 

The following command specifies that every 3rd data point (SP-3) 
starting at address 200 should be transferred. 

CMD$=”WFSU SP,3,FP,200” 

CALL IBWRT(SCOPE%,CMD$) 

INSPECT?, WAVEFORM, TEMPLATE 
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WAVEFORM TRANSFER 
DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
Response format 

EXAMPLE (GPIB) 



RELATED COMMANDS 



$ 9424 only 



WAVEFORM JTEXT, WFTX 

Command/Query 



The WAVEFORM TEXT command is used to document the con- 
ditions under which a waveform has been acquired. The text 
buffer is limited to 400 characters. 

The WAVEFORM TEXT? query returns the text section of the 
specified trace. 

<trace>:WaveForm_TeXt ’<text>’ 

<trace> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 
<text> := An ASCII message (max. 400 characters long) 

<trace>:WaveForm_TeXt? 

<trace>:WaveForm_TeXt “<text>” 

The following example shows how to document Function E (FE) . 

MSG$ = ” ’Averaged pressure signal. 

Experiment carried out Oct. 15, 88’” 

CMD$ = ’’FE.WFTX “+ MSGS 
CALL IBWRT(SCOPE%,CMD$) 

INSPECT?, WAVEFORM, TEMPLATE? 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 



EXAMPLE (GPIB) 
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XY_ASSIGN, XYAS 

Command/Query 



The XY ASSIGN command assigns traces to the X and Y axis to 
create an X versus Y display. 

The XY_ASSIGN? query returns the traces currently assigned to 
the XY display. If there is no trace assigned to the X-axis and/or 
the Y-axis the value UNDEF will be returned instead of the trace 
name. 

XY_ASsign <X_source>,<Y_source> 

<X_source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3$, C4$} 
<Y_source> := {EA, EB, MC, MD, FE, FF, Cl, C2, C3t, C4$} 

XY_ASsign? 

XY_ASsign <X_source>,<Y_source> 

<X_source> := {UNDEF, EA, EB, MC, MD, FE, FF, Cl, C2, 
C3$, C4$} 

<Y_source> := {UNDEF, EA, EB, MC, MD, FE, FF, Cl, C2, 
C3$, C4$} 

The following command will assign Channel 1 to X and Channel 2 
to Y. 

CMDS$=”XYAS C1,C2”: CALL IBWRT(SCOPE%,CMDS$) 
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CURSOR 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



XYCURSORORIGIN, XYCO 

Command/Query 



The XY_CURSOR_ORIGIN command sets the position of the ori- 
gin for absolute time cursor measurements on the XY display. 

Absolute time cursor values may be measured either with respect 
to the point (0,0) volts (OFF) or with respect to the center of the 
XY grid (ON). 

The XY_CURSOR_ORIGIN query returns the current assignment 
of the origin for absolute time cursor measurements. 

XY_Cursor_Origin <mode> 

<mode> := {ON, OFF} 

XY_Cursor_Origin? 

XY_Cursor_Origin <mode> 

The following command sets the origin for absolute time cursor 
measurements to the center of the XY grid. 

CMDS$=”XYCO ON”: CALL IBWRT(SCOPE%,CMDS$) 
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CURSOR 



DESCRIPTION 



COMMAND SYNTAX 



XY_CURSOR_SET, XYCS 

Command/ Query 



The XY_CURSOR_SET command allows the user to position any 
one of the nine independent XY cursors at a given screen location. 
The positions of the cursors can be modified or queried even if the 
required cursor is not currently displayed or if the XY display 
mode is OFF. 

The XY_CURSOR_SET? query indicates the current position of 
the cursor (s). The values returned are quoted relative to the origi- 
nal waveform (time or frequency domain). 



Notation 




LJ A DO 

i muo 


Horizontal absolute 


HREF 


Horizontal reference 


HDIF 


Horizontal difference 


XABS 


Vertical absolute on X axis 


XREF 


Vertical reference on X axis 


XDIF 


Vertical difference on X axis 


YABS 


Vertical absolute on Y axis 


YREF 


Vertical reference on Y axis 


YDIF 


Vertical difference on Y axis 



XY_Cursor_Set <cursor>,<position> 

[<cursor>,<position> . . . .<cursor>,<position>] 

<cursor> := {HABS, HREF.HDIF, XABS, XREF.XDIF, YABS, 
YREF, YDIF} 

<position> := 0 to 10 DIV (horizontal) 

- 4 to 4 DIV (vertical) 

Note 1: The suffix DIV is optional. 

Note 2: Parameters are grouped in pairs. The first one names the 
cursor to be modified and the second one indicates its new value. 
Pairs may be given in any order and may be restricted to those 
items to be changed. 
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QUERY SYNTAX 

Response Format 
EXAMPLE (GPIB) 



XY_Cursor_Set? [<cursor, . . .<cursor>] 

<cursor> := {HABS, HREF, HDIF, XABS, XREF, XDIF, YABS, 
YREF, YDIF, ALL} 

Note: If <cursor> is not specified, ALL will be assumed. 

XY__Cursor _Set <cursor>,<position>[<cursor>,<position>. . . 

. . . ,<cursor>,<position>] 

The following command positions the XREF and YDIF at +3 DIV 
and -2 DIV respectively. 

CMDS$=”XYCS XREF, 3DIV, YDIF, -2DIV” 

CALL IBWRT(SCOPE%,CMDS$) 
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CURSOR XY_CURSOR_VALUE, XYCV 

Command/Query 



DESCRIPTION The XY_CURSOR_VALUE? query returns the current values of 

the X versus Y trace parameters. The X versus Y trace does not 
need to be displayed to obtain these parameters, but valid sources 
must be assigned to the X and Y axes. 

Parameter Names ccursor type>_X X 

ccursor type>_Y Y 

ccursor type>_RATIO AY/AX 

ccursor type>_PROD AY * AX 

ccursor type>_ANGLE arc tan (AY/ AX) 

ccursor type>_RADIUS sqrt(AX*AX + AY* AY) 
ccursor_type> := [HABS, HREL, VABS, VREL] 

QUERY SYNTAX XY_Cursor_Value? [cparameter>, . . .cparameter>] 

cparameter> := {HABS_X, HABS_Y, HABS_RATIO, 
HABS_PROD, HABS_ANGLE, HABS_RADIUS, HREL_X, 
HREL_Y, HREL_RATIO, HRELPROD, HREL_ ANGLE, 
HREL_RADIUS, VABS_X, VABS_Y, VABS_RATIO, 
VABS_PROD, VABS_ANGLE, VABS_RADIUS, VREL_X, 
VREL_Y, VREL RATIO, VREL PROD, VREL_ ANGLE, 
VREL RADIUS, ALL} 

Note: If <parameter> is not specified or equals ALL, all the mea- 
sured cursor values are returned. If the value of a cursor could not 
be determined in the current environment, the value UNDEF will 
be returned. 

Response Format XY_Cursor_Value cparameter>,cvalue> 

[ . . . .cparameter>,cvalue>] 

cvalue> := decimal value or UNDEF 

EXAMPLE (GPIB) The following query reads the ratio of the absolute horizontal cur- 

sor, the angle of the relative horizontal cursor and the product of 
the absolute vertical cursor. 

CMDS$=”XYCV?HABSJRATIO,HREL_ANGLE,VABS_PROD 
CALL IBWRT(SCOPE%,CMDS$) 
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DISPLAY 



XY DISPLAY, XYDS 

Command/ Query 



DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
Response Format 

EXAMPLE (GPIB) 



The XY_DI SPLAY command enables or disables the XY display 
mode. 

The XY_DISPLAY? query returns the current mode of the XY 
display. 

XY_DiSplay <mode> 

<mode> := {ON, OFF} 

XY_DiSplay? 

XY_DiSplay <mode> 

The following command turns the XY display ON. 
CMDS$=”XYDS ON”: CALL IBWRT(SCOPE%,CMDS$) 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 

Response format 

EXAMPLE (GPIB) 
RELATED COMMANDS 



$ 9424 only 



ZOOM 

Command/Query 



The ZOOM command allows the user to select which trace is to be 
expanded by one of the expansion functions. 

The response to the ZOOM? query indicates which trace is cur- 
rently expanded. 

In the 9424 the ZOOM command automatically switches the func- 
tion to the expand state 

< exp_trace > :ZOOM <trace> 

<ex P_ trace> := {EA, EB, MC$, MD$} 

<trace> := {MC, MD, FE, FF, Cl, C2, C3$, C4$} 



<e xp_trace >: ZOOM? 

<e xp_trace >: ZOOM <trace> 

The following example selects Memory C (MC) as the source for 
Expand B (EB). 

CMD$=”EB:ZOOM MC”: CALL IBWRT(SCOPE%,CMD$) 
DUAL ZOOM 
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WAVEFORM STRUCTURE 



INTRODUCTION 



LOGICAL DATA BLOCKS 
OF A WAVEFORM 



This section discusses how to read and write waveforms and under- 
stand their contents. Waveforms can be divided into two basic 
entities, the basic data array (i.e. the raw data values from the 
ADC’s in the acquisition) and the accompanying descriptive infor- 
mation, such as vertical scale, horizontal scale, time of day which 
are necessary for a full understanding of the data. 

The information in a waveform can be accessed using the IN- 
SPECT? command which interprets it in an easily understood 
ASCII text form. It can also be more rapidly transferred using the 
WAVEFORM? command or written back into the instrument with 
the WAVEFORM command. The oscilloscope contains a data 
structure called the template which is a detailed description of how 
the waveform’s information is organized. 



The template gives a detailed description of the form and contents 
of the logical data blocks of a waveform. It is provided as a refer- 
ence to be used by you and your programs. A sample template is 
given in Appendix B although you are encouraged to use the 
TEMPLATE? command to examine the actual template that your 
instrument is using. The template may change as the instrument’s 
firmware is enhanced. The template will help provide backward 
compatibility for the interpretation of waveforms. 

Usually, a waveform will contain just a Waveform descriptor block 
(1.) and a Data array block (5.). In more complicated cases one 
or more of the other blocks will be present. The data blocks are: 

1. Waveform descriptor block (WAVEDESC) . This block in- 
cludes all the information necessary to reconstitute the display 
of the waveform from the data. This includes: 

• hardware settings at the time of acquisition 

• the exact time of the event 

9 the kinds of processing that have been performed 

• the name and serial number of the instrument 

• the encoding format used for the data blocks 

• miscellaneous constants 

2. An optional user-provided text (USERTEXT) . The WFTX 
command can be used to put a title or description of a wave- 
form into this block. The WFTX? query command gives an 
alternative way to read it. This text block can hold up to 400 
characters. However, you should limit the length of each line to 
about 45 characters, otherwise the text will be wrapped onto 
the next line after 56 characters. 

3. A block of sequence acquisition times (TRIGTIME) . This 
block is needed for sequence acquisitions to record the exact 
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timing information for each segment. It contains the time of 
each trigger relative to the trigger of the first segment, as well as 
the time of the first data point of each segment relative to its 
trigger. 

4. A block of random interleaved sampling times (RISTIME). 
This block is needed for RIS acquisitions to record the exact 
timing information for each segment. 

5. A data array block (SIMPLE or DATA ARRAY l) . This is 
the basic integer data of the waveform. It can be raw or cor- 
rected ADC data or the integer result of waveform processing. 

6. A second data array block (DATA ARRAY 2) . This second 
data array is needed to hold the results of processing functions 
such as the Extrema (WP01 option) or Complex FFT (VVP02 
option). In such cases, the data arrays contain: 

Extrema FFT 

DATA_ARRAY_1 Roof trace Real part 

DATA_ARRAY_2 Floor trace Imaginary part 

Note: The TEMPLATE also describes an array named DUAL. 
This is simply a way to allow the INSPECT? command to examine 
the two data arrays together. 

INSPECT? COMMAND This is the simplest way to examine the contents of a waveform. It 

can be used on both the data and descriptive parts. The simplest 
form of the command is: 

INSPECT? “name” 

where the template gives the name of a descriptor item or data 
block. The answer is returned as a single string, but may span 
many lines. Here is some typical dialogue: 

question Cl INSPECT? “VERTICAL_OFFSET” 

response ClrlNSP “VERTICAL_OFFSET : 1.5625e-03 
question Cl: INSPECT? “TRIGGER TIME” 

response ClrlNSP ” 

TRIGGER_TIME : Date = FEB 17, 1989, Time= 4: 4:29.5580 

The INSPECT? command can also be used to get a readable trans- 
lation of the full waveform descriptor block with the command: 

INSPECT? “WAVEDESC” 

The template dump from your instrument (or from Appendix B) 
will give details on the interpretation of each of the parameters. 
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The INSPECT? command is also used to examine the measured 
data values of a waveform. For an acquisition with 42 points we 
get: 



INSPECT? “ 
Cl :INSP ” 


SIMPLE” 










4. 68749e-03 


1.09375e-02 


1.71875e-02 


2.03125e-02 


2.03125e-02 


2. 65625e-02 


3.28125e-02 


3.59375e-02 


3.90625e-02 


4.53125e-02 


5. 15625e-02 


5. 15625e-02 


5.78125e-02 


6.40625e-02 


6.71875e-02 


6.71875e-02 


7.65625e-02 


7. 96875e-02 


8.59375e-02 


S.90625e-02 


9.21875e-02 


9.53125e-02 


1.04687e-01 


1.04687e-01 


1.07812e-01 


1. 14062e-01 


1.20312e-01 


1.20312e-01 


1.26562e-01 


1.29688e-01 


1.32812e-01 


1 . 39062e-01 


1.42187e-01 


1.51562e-01 


1 . 54687e-01 


1 . 57812e-01 


1.60938e-01 


1.60938e-01 


1.70312e-01 


1.73437e-01 


1.70312e-01 


1.76563e-01 



These numbers are the fully converted measurements in volts. Of 
course, when the data block contains thousands of items the string 
will contain many lines. 
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its raw form as either a BYTE (8 bits) or a WORD (16 bits) for 
each data value. In this case you must use the relations given below 
in association with the WAVEFORM? command to interpret the 
measurement. The command might then say: 

INSPECT? “SIMPLE”, BYTE 



The examination of data values for waveforms with two data arrays 
can be done as follows: 



INSPECT? “DUAL” to get pairs of data values on a single line 

INSPECT? “ DATA_ARRAY_1 ” 

to get the values of the first data array 

INSPECT? “DATA_ ARRAY 2” 

to get the values of the second data array 

It is also possible to examine just a part of the waveform or a 
sparsed form of the waveform. This is controlled with the WAVE- 
FORM SETUP command mentioned later in this section. 

The INSPECT? command has only a query form. It cannot be 
used to send a waveform back into the oscilloscope. It is also a very 
verbose way in which to send the information and is not very fast. 
Users who need speed or the ability to send the waveform back to 
the instrument should use the WAVEFORM commands. 

BASIC users might find it convenient to combine the capabilities 
of the inspect facility with the waveform query command in order 
to construct files containing a human and BASIC readable version 
of the waveform descriptor together with the full waveform in a 
format suitable for retransmission to the instrument. This can be 
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WAVEFORM? COMMAND 



Interpreting the 
waveform descriptor 



done for a waveform in a memory location by sending the com- 
mand: 

MC: INSPECT? “ WAVEDESC” ; WAVEFORM? 
and putting the response directly into a disk file. 



The WAVEFORM commands are an efficient way to transfer 
waveform data using the block formats defined in the IEEE-488.2 
standard. You have the possibility of reading all of the logical 
blocks of the waveform with a single query: 

Cl: WAVEFORM? 

This is the preferred form for most applications since it is complete 
and the response can be downloaded back into the instrument 
using the WAVEFORM command. You can also choose to read 
any single block with a query like: 

Cl WAVEFORM? DAT! 

This can save time and space when you need to read many wave- 
forms all with the same acquisition conditions or if you are only 
interested in lots of raw integer data. Consult the description of the 
WAVEFORM command in Section 5 for the names of the various 
blocks. 

Please be aware that a waveform query response can easily be a 
block containing over 200,000 bytes if it is in binary format and 
twice as much if the HEX option is used. 



The binary response to a query command of the form: 

Cl: WAVEFORM? or Cl WAVEFORM? ALL 
can be put into a disk file and then dumped to show the following 
hexadecimal and ASCII form: (This was done over GPIB with de- 
fault settings) 
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Byte Binary contents in hexadecimal 
offset 



0 


4331 


CA57 


4620 


414C 


4c2c 


2339 


3030 


16 


3030 


3433 


3057 


4156 


4544 


4553 


4300 


32 


OOOO 


0000 


004C 


4543 


524f 


595f 


315 f 


48 


OOOO 


0000 


0000 


0100 


OOOO 


0001 


5a00 


64 


OOOO 


0000 


OOOO 


OOOO 


OOOO 


OOOO 


OOOO 


80 


OOOO 


0000 


5400 


OOOO 


OOOO 


OOOO 


OOOO 


96 


004C 


4543 


524f 


5939 


3435 


305f 


OOOO 


112 


0005 


alf4 


blOO 


OOOO 


OOOO 


OOOO 


OOOO 


128 


0000 


0000 


0000 


OOOO 


OOOO 


OOOO 


2aOO 


144 


2800 


0000 


0000 


OOOO 


2900 


OOOO 


OOOO 


160 


0100 


0000 


0000 


OOOO 


0100 


OOOO 


0100 


176 


0037 


4ccc 


cd3a 


cccd 


0046 


feOO 


00c7 


192 


0000 


0800 


0031 


2bcc 


77be 


49fe 


783b 


208 


OObe 


4579 


8ee0 


OOOO 


0056 


OOOO 


OOOO 


224 


0000 


0000 


0000 


OOOO 


OOOO 


OOOO 


OOOO 


240 


0000 


0000 


0000 


OOOO 


OOOO 


OOOO 


OOOO 


256 


0000 


0000 


0000 


OOOO 


0053 


OOOO 


OOOO 


272 


0000 


0000 


0000 


OOOO 


OOOO 


OOOO 


OOOO 


288 


0000 


0000 


0000 


OOOO 


OOOO 


OOOO 


OOOO 


304 


0000 


0000 


0000 


OOOO 


OOOO 


OOOO 


0040 


320 


d913 


4ab0 


0004 


0401 


0407 


d200 


OOOO 


336 


0000 


0000 


0000 


OOOO 


OOOO 


OCOO 


003 f 


352 


0000 


ofoo 


003 f 


8000 


003c 


8000 


2000 


368 


0004 


0006 


0007 


0007 


0009 


000b 


000c 


384 


ooof 


0011 


0011 


0013 


0015 


0016 


0016 


400 


001a 


001C 


OOld 


OOle 


OOlf 


0022 


0022 


416 


0025 


0027 


0027 


0029 


002a 


002b 


002d 


432 


0031 


0032 


0033 


0034 


0034 


0037 


0038 


448 


0039 


000a 















ASCII translation 
(b is for uninteresting) 


3030 


Cl : WF ALL, #90000 


OOOO 


0043QWAVEDESCbbb 


3100 


bbbbbLECROY_l_lb 


OOOO 


bbbbbbbbbbbbbbbb 


OOOO 


bbbbbbbbbbbbbbbb 


OOOO 


bbbbbbbbbbbbbbbb 


OOOO 


bLECR0Y9450_bbbb 


OOOO 




OOOO 




OOOO 




OOOO 




OOOO 




e800 




OOOO 




OOOO 




OOOO 




OOOO 




OOOO 




OOOO 




3d8e 




OOOO 




8000 




0002 




OOOd 




0019 




0023 




002e 




0037 





It can be seen that the first 10 bytes translate into ASCII and look 
like the simple beginning of a query response. This is followed by 
the string “#9000000430”. This is the beginning of a binary block 
where 9 ASCII integers are used to give the length of the block 
(430 bytes). The waveform itself starts immediately after this at 
byte number 21 (the first byte is byte 0). 



Deciphering the waveform descriptor can be done with the aid of 
the template (see Appendix B) . It states that the first object is a 
DESCRIPTOR_NAME which is a string of 16 characters with the 
value WAVEDESC and this is what we see. At byte 16 relative to 
the beginning of the descriptor (or byte 37 above) we find the next 
string, the TEMPLATE_NAME with the value LECROY_l_l. 
Several other parameters follow. We can easily recognize the IN- 
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STRUMENT_NAME at 76 bytes from the descriptor start (or byte 
97 above). 

In a similar way we learn that a 4 byte long integer giving the length 
of the descriptor starts at byte 36 (or byte 57 above): 

WAVEDESCRIPTOR = 15a (hex) = 346 

At byte 60 (or byte 8 1 above) we find another 4 byte integer giving 
the length of the data array: 

WAVE_ARRAY_1 = 54 (hex) = 84 

and at byte 116 (or byte 137 above) the number of data points: 

W A VE_ ARRA Y_CO U NT = 2a (hex) = 42 

Now we know that the data will start at byte 346 from the begin- 
ning of the descriptor (or byte 367 above) and that each of the 42 
data points will be represented by two bytes. The waveform has a 
total length of 346 + 84 which is the same as the ASCII string told 
us at the beginning of the block. The final 0a at byte 45 1 is the NL 
character associated with the GPIB message terminator 
<NLxEOI>. 

The data can be easily seen starting at byte 367 above. Since the 
oscilloscope has an 8 bit ADC we see those 8 bits followed by a 0 
byte for each data point. It should be noted that for many other 
kinds of waveform this second byte will not be zero and contains 
interesting information. The data is coded in signed form (two’s 
complement) with values ranging from -32768 = 8000 (hex) to 
32767 = 7fff (hex). If we had chosen to use the BYTE option for 
the data format the values would have been signed integers in the 
range -128 = 80 (hex) to 127 = 7f (hex). 



Interpreting the 

waveform vertical data Now that we know how to decipher the data it would be useful to 

convert it to the appropriate measured values. The vertical reading 
for each data point depends on the vertical gain and the vertical 
offset given in the descriptor. For acquisition waveforms this corre- 
sponds to the volts/div and voltage offset selected after conversion 
for the data representation being used. The template tells us that 
the vertical gain and offset can be found at bytes 156 and 160 
respectively of the descriptor and that they are stored as floating 
point numbers in the IEEE 32 bit format. An ASCII string giving 
the vertical unit is to be found in VERTUNIT, byte 196. The verti- 
cal value is given by the relationship: 

value = VERTICAL_GAIN * data - VERTICAL_OFFSET 

A data value of 0 is normally displayed as a point in the middle of 
the grid. 
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Calculating the horizontal 
position of a data point 



In the case of the data shown above we find: 



VERTICAL_GAIN = 1.220703 14e-05 from the floating 

point number 374c cccd at byte 177 

VERTICALJDFFSET = 1.56250596e-03 from the floating 

point number 3acc cdOO at byte 181 

VERTICAL UNIT = V = volts from the string 5600 ... at byte 

217 



and therefore: 



since data[0] 
value [0] 
and 



= 512 from the hexadecimal word 0200 at byte 
367 

= 0.00468 V as stated in the inspect command 
above 



since data[l] = 1024 from the hexadecimal word 0400 at byte 
369 

value [0] = 0.0109 V as stated in the inspect command 

above . 



If your computer or available software is incapable of understand- 
ing the IEEE floating point values you can find a description of this 
format in the template (see Appendix B). 

The data values in a waveform may not all correspond to measured 
points. The parameters, FIRST_VALID_PNT and LAST_VAL- 
ID_PNT give the necessary information. The descriptor also 
records the SPARSING_F ACTOR, the FIRST_POINT, and the 
SEGMENTJNDEX to aid interpretation if the options of the 
WAVEFORM_SETUP command have been used. 

For sequence acquisitions the data values for each segment are 
given in their normal order and the segments are read out one 
after the other. The important descriptor parameters are the 
WAVE ARRAY COUNT and the SUBARRAY_COUNT, giving 
the total number of points and the number of segments. 

For waveforms such as the extrema and the complex FFT there 
will be two arrays one after the other for the two arrays of the 
result. 



Each vertical data value has a corresponding horizontal position, 
usually measured in time or in frequency units. The calculation of 
this position depends on the type of waveform being examined. 
We will treat separately the single sweep, the sequence, and the 
interleaved (RIS) waveform. Each data value has a position, i, in 
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the original waveform with i = 0 corresponding to the first data 
point acquired. The descriptor parameter HORUNIT gives a string 
with the name of the horizontal unit. 

• Single-sweep waveforms 

x[i] = HORIZ_INTERVAL * i + HORIZ_OFFSET 

For acquisition waveforms this time is from the trigger to the data 
point in question. It will be different from acquisition to acquisition 
since the HORIZjOFFSET is measured for each trigger. 

In the case of the data shown above this means: 

HORIZ_INTERVAL = 2.5000e-09 from the floating point num- 
ber 312b cell at byte 197 

HORIZJOFFSET = -1.21044098e-08 from the double preci- 
sion floating point number be49 fe78 
3be8 0000 at byte 201 

HORUNIT = S = seconds from the string 5300 ... at byte 

265 

which gives 

x[0] = -1.210e-08 S 

x[l] = -0.960e-08 S 

• Sequence waveforms 

Since sequence waveforms are really many independent acquisi- 
tions, each segment will have its own horizontal offset. These can 
be found in the TRIGTIME array. For the n’th segment 

x[i,n] = HORIZ_INTERVAL * i + TRIGGER_OFFSET[n] 

The TRIGTIME array can contain up to 200 segments of timing 
information with two 8 byte double precision floating point num- 
bers for each segment. 

• Interleaved (RIS) waveforms 

These waveforms are composed of many acquisitions interleaved 
together. The descriptor parameter, SWEEPS_PER_ACQ gives 
the number of acquisitions. The i’th point will belong to the m’th 
segment where 

m = i modulo (SWEEPS JPER__ACQ) 

will have a value between 0 and SWEEPS_PER_ACQ - 1. 

Then with 

j = i - m 

x[i] = x[j,m] = HORIZ_INTERVAL * j + RIS_OFFSET[m] 




Waveform Structure 



where the RIS_OFFSET’s can be found in the RISTIME array. 
There can be up to 100 8 byte double precision floating point num- 
bers in this block. The instrument tries to get segments with times 
such that 



RIS_OFFSET[i] « PIXEL_OFFSET + (i - 0.5) * HORIZ_IN 

TERVAL 



Thus, taking as an example a RIS with SWEEPS_PER_ACQ = 10 
HORIZ_INTERVAL = 1 ns and PIXEL_OFFSET = 0.0, we might 



find for a particular event that: 
RIS_OFFSET[Q] =-0.5 ns 
RIS_OFFSET[2] = 1.6 ns 
RIS_OFFSET[4] = 3.4 ns 
RIS_OFFSET[6] = 5.6 ns 
RIS_OFFSET[8] = 7.6 ns 

and therefore: 

x[0] = RIS_OFFSET[0] = 

x[l] = RIS_OFFSET[l] = 



x[9] = RIS_OFFSET[9] = 
x[10] = 1 ns * 10 + (-0.5) = 
x[ll] = 1 ns * 10 + 0.4 



RIS_OFFSET[ 1] = 0.4 ns 
RIS_OFFSET[3] = 2.6 ns 
RIS_OFFSET[5] = 4.5 ns 
RIS_OFFSET[7] = 6.4 ns 
RIS_OFFSET[9] = 8.5 ns 

-0.5 ns 
0.4 ns 



8.5 ns 

9.5 ns 
10.4 ns 



x[19] = 1 ns * 10 + 8.5 = 18.5 ns 

x[20] = 1 ns * 20 + (-0.5) = 19.5 ns 



WAVEFORM COMMAND Waveforms that have been read in their entirety with the WAVE- 
FORM? command can be sent back into the instrument. Since the 
descriptor contains all of the necessary information, you do not 
have to be careful about any of the communication format param- 
eters. The instrument can learn all that it needs to know from the 
waveform. 

If you want to synthesize waveforms for display or comparison pur- 
poses, you are encouraged to read out a waveform of the 
appropriate size and then replace the data with the desired values. 
This will assure that the descriptor is coherent. 

Note: You are only allowed to send back waveforms to memory 
traces (MC or MD for 2-channel instruments or MC, MD, FE 
and FF for the 9424). This means that you may have to remove or 
change the prefix (Cl or CHANNEL_J ) in the response to the WF? 
query. The examples for the WF command in Section 5 show how 
this can be done. 
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MORE CONTROL OF 
WAVEFORM QUERIES 



HIGH-SPEED 
WAVEFORM TRANSFER 



There are many different ways for you to use the WAVEFORM? 
command which may simplify or speed up your work. Among 
them are: 

® Partial readout of waveform 

The WAVEFORM_SETUP command allows you to specify a 
short part of a waveform for readout. It also lets you select a spars- 
ing factor to read only every n’th data point. 

• Byte swapping 

The COMM ORDER command allows you to swap the two bytes 
of a 16-bit word. In fact, byte swapping is done for all numbers 
represented by more than one byte. This is the case for the des- 
criptor, the time blocks, and WORD arrays, thereby simplifying 
data interpretation for some computer systems (e.g. INTEL based, 
or DEC) 

• Data length, block format, and encoding 

The COMM_FORMAT command gives you control over these 
parameters. If you do not need the extra precision of the lower 
order byte of the standard data value, the BYTE option lets you 
save a factor of two on the amount of data to be transmitted or 
stored. If your computer is not able to read binary data, the HEX 
option allows a response form where the value of each byte is given 
by a pair of hexadecimal digits. 

• Data only transfers 

The COMM HEADER OFF mode will allow you to get a response 
to WF? DAT1 with the data only (the C1:WF DAT1 will disap- 
pear). 

If you have also specified COMM_FORMAT OFF, BYTE, BIN, 
you will just get a response of data bytes (the #90000nnnnn will 
disappear) . 

« Formatting for RS-232 users 

The COMM_RS232 command can help you by splitting the very 
long WF? response into individual lines 



In order to achieve the maximum continuous data transfer rates 
from the oscilloscope to your instrument you will have to optimize 
many factors. The single most important point is to limit the work 
done in your computer. This means avoiding having to write the 
data to disk, minimizing the per data point computations, minimiz- 
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ing the number of calls to the IO system, etc. You can let the 
instrument help by reducing the number of points to be transferred 
and the number of data bytes per point. The pulse parameter ca- 
pability and the processing functions can save you lots of 
computing and lots of data transfer time if employed creatively. 
Two other very important principles are: 

• Try to overlap waveform acquisition with waveform transfer. The 
oscilloscope is capable of transferring an already acquired or pro- 
cessed waveform after a new acquisition has been started. This can 
also considerably increase the total time that the oscilloscope will 
be able to acquire events if it has to wait for triggers (livetime) . 

• Minimize the number of waveform transfers by using the se- 
quence mode to accumulate many triggers for each transfer. This 
is preferable to using the WAVEFORM_SETUP command to re- 
duce the number of data points to be transferred. It also reduces 
the oscilloscope transfer overhead significantly. 

t-I arn tc nr% avomnlo r\ f tKo f pnmmonrlc tr\ Vic* OHADn • 

JL1V/I V IO CUL1 VA.ailipiV \J A U1V- tjjp’V \JJL WUllJUliWllVtU tw giv 

ARM to acquire the first event or sequence 

WAIT; ARM;C 1 : WF? to wait for the event, start the next acqui- 

sition and then transfer the data. 

This second line can be repeated by your program as soon as it has 
finished reading the waveform. 
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STATUS REGISTERS 



An extensive set of status registers allows the user to quickly deter- 
mine the oscilloscope’s internal processing status at any time. The 
status registers as well as the status reporting system have been 
designed to comply with IEEE 488.2 recommendations. 

Related functions are grouped together in common status registers. 
Some, such as the Status Byte Register (STB) or the Standard 
Event Status Register (ESR), are required by the IEEE 488.2 stan- 
dard. However, other registers are device specific. They include 
the Command Error Register (CMR) or the Execution Error Reg- 
ister (EXR). Commands associated with IEEE 488.2 mandatory 
status registers are preceded by an asterisk <*>. 



OVERVIEW OF STATUS 
AND SERVICE REQUEST 

REPORTING Figure 2 shows the organization of the 9420/24/50 status registers. 

The central reporting structure is the Status Byte Register (STB) . 
It consists of 8 bits, three of which are not used. 

The Standard Event Status Bit (ESB) and the Internal Status 
Change Bit (INB) in the Status Byte Register are summary bits of 
the Standard Event Status Register (ESR) and the Internal State 
Change Register (INR) . The Message Available Bit (MAV) is set 
whenever there are data bytes in the output queue. The Value 
Adapted Bit (VAB) indicates that a parameter value was adapted 
during a previous command interpretation (e.g. if the command 
“TDIV 2.5 US” is received, the time base is set to 2 psec/div and 
the VAB bit is set). 

The Master Summary Status bit (MSS) indicates that the instru- 
ment requests service. The MSS bit can only be set if any of the 
other bits of STB are enabled with the Service Request Enable 
Register (SRE). 

All Enable registers (SRE, ESE and INE) are used to generate a 
bitwise AND with their associated status registers. The logical OR 
of this operation is reported to the STB register. At power-on, all 
Enable registers are zero, inhibiting any reporting to the STB. 

The Standard Event Status Register (ESR) mostly summarizes er- 
rors, whereas the Internal State Change Register (INR) reports 
internal changes in the instrument. Additional details of the errors 
reported by ESR can be obtained with the queries “CMR?”, 
“DDR?”, “EXR?” and “URR?” . 
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Logical OR 



Power ON 

User request (URR?) 

Command error found CMR?) 
Execution error detected (EXR?) 
Device specific error (DDR?) 
Query error 

Request control (unused) 
Operation complete 



Standard Event 
Status Register 
Read by *ESR? 



Internal State 
Change Register 
Read by INR? 



Function F processing terminated 
Function E processing terminated 
Return-to-local detected 
■Screen dump terminated 
New signal acquired 



1110 



2 10 







Internal State Change 




Enable Register 


Status Byte Register 


Set by INE n 


Read by Serial Poll 


Read by INE? 


Read by 'STB? 




In a 9424, 


bits 8, 9 are 


used for Function C, D 


processing terminated 


Service Request 




Enable Register 




Set by *SRE n 




Read by *SRE? 





STATUS REGISTER STRUCTURE OF 9420/24/50 

Figure 2 
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Example of status reporting 



Summary 



STATUS BYTE REGISTER 
(STB) 



The register structure contains one more register (not shown in 
Figure 2) . It is the Parallel Poll Enable Register (PRE) which acts 
exactly like the Service Request Enable Register (SRE) , but it sets 
the “ ist” bit (not shown in Figure 2) , used in the Parallel Poll. The 
“ist” bit can also be read with the “ *IST?” query. 

If an erroneous remote command, e.g. “TRIG MAKE SINGLE”, 
is transmitted to the instrument, it rejects the command and sets 
the Command Error Register (CMR) to the value 1 (unrecognized 
command/query header) . The non-zero value of CMR is reported 
to bit 5 of the Standard Event Status Register (ESR) which is then 
set. 

Nothing further happens unless the corresponding bit 5 of the 
Standard Event Status Enable Register (ESE) is set (with the com- 
mand “ *ESE 32”), enabling the fact that bit 5 of ESR is set to be 
reported to the summary bit ESB of the Status Byte Register 
(STB). 

If setting of the ESB summary bit in STB is enabled, again nothing 
happens unless further reporting is enabled by setting the corre- 
sponding bit in the Service Request Enable Register (with the 
command “ *SRE 32”). In this case, the generation of a non-zero 
value of CMR ripples through to the Master Summary Status bit 
(MSS), generating a Service Request (SRQ). 

The value of CMR can be read and simultaneously reset to zero at 
any time with the command “CMR?”. The occurrence of a com- 
mand error can also be detected by analyzing the response to 
“■“ESR?”. However, if several types of potential errors must be 
surveyed, it is usually much more efficient to enable propagation 
of the errors of interest into the STB with the enable registers ESE 
and INE. 

A command error (CMR) sets bit 5 of ESR: 

• if bit 5 of ESE is set, ESB of STB is also set. 

• if bit 5 of SRE is set, MSS/RQS of STB is also set and a 
Service Request is generated. 



The Status Byte Register is the instrument’s central reporting struc- 
ture. The STB is composed of 8 single-bit summary messages (of 
which 3 are unused) which reflect the current status of the asso- 
ciated data structures implemented in the instrument. 

Bit 0 is the summary bit 1NB of the Internal State Change Register. 
It is set if any of the bits of the INR are set, provided that they are 
enabled by the corresponding bit of the INE register. 
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Bit 2 is the Value Adapted Bit, indicating that a parameter value 
was adapted during a previous command interpretation. 

Bit 4 is the Message Available (MAV) bit, indicating that the in- 
terface output queue is not empty. 

Bit 5 of STB is the summary bit ESB of the Standard Event Status 
Register. It is set if any of the bits of the ESR are set, provided that 
they are enabled by the corresponding bit of the ESE register. 

Bit 6 of the Status Byte Register (STB) is alternatively called the 
Master Summary Status bit (MSS) or the Request for Service bit 
(RQS) because the STB can be read in two different ways. The 
command “ * STB?” reads and clears the STB in the query mode in 
which case bit 6 of the STB is the MSS bit, indicating if the instru- 
ment has any reason for requesting service. The other way of 
reading the STB is the serial poll (see Section 3, page 22, for the 
GPIB serial poll procedure). In this case, bit 6 of the STB is the 
RQS bit, indicating the instrument has actually activated the SRQ 
line on the GPIB. The serial poll only clears the RQS bit. There- 
fore, the MSS bit of the STB (and any other bits which caused 
MSS to be set) will stay set after a serial poll. The controller must 
reset these bits. 

The Status Byte Register may be read via the query “ *STB?” . The 
response represents the binary weighted sum of the register bits. 
The register is cleared by “*STB?”, “ALST?”, “*CLS” or after 
the instrument has been powered up. 



STANDARD EVENT 

STATUS REGISTER (ESR) The ESR is a 1 6— bit register reflecting the occurrence of events. 

The register bit assignments have been standardized by 
IEEE 488.2. Only the lower 8 bits are currently in use. 

The Standard Event Status Register may be read via the query 
“ *ESR?”. The response is the binary weighted sum of the register 
bits. The register is cleared with an “ *ESR?” or “ALST?” query, a 
“ *CLS” command or after power-on. 

Example The response message “ *ESR 160” indicates that a command er- 

ror occurred and that the ESR is being read the first time after 
power-on. The value 160 can be broken down into 128 (bit 7) 
plus 32 (bit 5). See Table 5, page 80, for a description of the 
conditions corresponding to the bits set.. 

The “Power ON” bit appears only on the first “ *ESR?” query after 
power-on because the query clears the register. The type of com- 
mand error can be determined by reading the Command Error 
Status Register with the query “CMR? ”. Note that it is not neces- 
sary to read (and simultaneously clear) this register in order to be 
able to set the CMR bit in the ESR on the next command error. 
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STANDARD EVENT 
STATUS ENABLE 

REGISTER (ESE) The ESE allows one or more events in the Standard Event Status 

Register to be reported to the ESB summary bit in the STB. 

The Standard Event Enable Register is modified with the com- 
mand “ ’“ESE”. It is cleared with the command “ “ESE 0”, or after 
power-on. It may be read with the query “*ESE?”, 



Example 



“*ESE 4” sets bit 2 (i.e. binary 4) of the standard event enable 
register, enabling query errors to be reported. 



SERVICE REQUEST 
ENABLE REGISTER (SRE) 



The Service Request Enable Register specifies which summary 
bit(s) in the Status Byte Register will cause a service request. The 
Service Request Enable Register consists of 8 bits. Setting a bit in 
the register allows the summary bit located at the same bit position 
in the Status Byte Register to generate a service request provided 
that the associated event becomes true. Bit 6 (MSS) cannot be set 
and is always reported as zero in response to the query “ “SRE?” . 



The Standard Event Enable Register is modified with the com- 
mand “ *SRE” . It is cleared with the command “ “SRE 0”, or after 
power-on. It may be read with the query ““SRE?”. 



PARALLEL POLL 

ENABLE REGISTER (PRE) The Parallel Poll Enable Register specifies which summary bit(s) in 

the Status Byte Register will set the “ist” individual local message. 
This register is quite similar to the Service Request Enable Register 
(SRE), but it is used to set the parallel poll “ist” bit rather than 
MSS. 

The value of the “ist” may also be read without a Parallel Poll via 
the query “ “1ST?”. The response indicates if the “ist” message has 
been set or not (values are 1 or 0). 

The Parallel Poll Enable Register is modified with the command 
“ “PRE” . It is cleared with the command “ “PRE 0”, or after pow- 
er-on. It may be read with the query ““PRE?”. (See Section 3, 
page 23, for the GPIB parallel poll procedure.) 

Example “ * PRE 5” sets bits 2 and 0 (decimal 4 and 1) of the Parallel Poll 

Enable Register. 



INTERNAL STATE CHANGE 

STATUS REGISTER (INR) The INR reports the completion of a number of internal opera- 
tions. The events tracked by this 16-bit-wide register are listed 
with the command “INR?” in Section 5. 
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The Internal State Change Status Register may be read via the 
query “INR?”. The response is the binary weighted sum of the 
register bits. The register is cleared with an “INR?” or “ALST?” 
query, a “ *CLS” command or after power-on. 



INTERNAL STATE CHANGE 

ENABLE REGISTER (INE) The INE allows one or more events in the Internal State Change 

Status Register to be reported to the INB summary bit in the STB. 

The Internal State Change Enable Register is modified with the 
command “INE”. It is cleared with the command “INE 0”, or 
after power-on. It may be read with the query “INE?”. 



COMMAND ERROR STATUS 

REGI STER (CMR) The Command Error Status register contains the code of the last 

command error detected by the instrument. Command error 
codes are listed with the command “CMR?” in Section 5. 

The Command Error Status Register may be read via the query 
“CMR?”. The response is the error code. The register is cleared 
with a “CMR?” or “ALST?” query, a “ *CLS” command or after 
power-on. 

DEVICE DEPENDENT 
ERROR STATUS 

REGISTER (DDR) The DDR indicates the type of hardware errors affecting the in- 

strument. Individual bits in this register report specific hardware 
failures. They are listed with the command “DDR?” in Section 5. 

The Device Dependent Error Status Register may be read via the 
query “DDR?”. The response is the binary weighted sum of the 
error bits. The register is cleared with a “DDR?” or “ALST?” 
query, a “ *CLS” command or after power-on. 



EXECUTION ERROR 
STATUS REGISTER 

(EXR) The Execution Error Status Register contains the code of the last 

execution error detected by the instrument. Execution error codes 
are listed with the command “EXR?” in Section 5. 

The Execution Error Status Register may be read via the query 
“EXR?”. The response is the error code. The register is cleared 
with a “EXR?” or “ALST?” query, a “ *CLS” command or after 
power-on. 



USER REQUEST STATUS 

REGISTER (URR) The URR contains the identification code of the last menu button 

which was pressed. The codes are listed with the command 
“URR?” in Section 5. 
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The User Request Status Register may be read via the query 
“URR?”. The response is the decimal code associated with the 
selected menu button. The register is cleared with a “URR?” or 
“ALST?” query, a “*CLS” command or after power-on. 
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EXAMPLE 1: 

USE OF THE INTERACTIVE 

GPIB PROGRAM ’IBIC’ This example assumes the use of an IBM PC, or a compatible comput- 

er, equipped with a National Instruments GPIB interface card. It also 
assumes that the GPIB-driver is left in the default state so that the 
device name “dev4” corresponds to the GPIB address 4 which is as- 
sumed to be the address of the oscilloscope. All text entered by the 
user is underlined. 

ibk<CR> 

program announces itself 
: . ib.fmd<CR> 

enter board/device name: dev4<CR> 

dev4: ibwrt<CR> 

enter string: “tdiv?”<CR> 

[0100] ( cmpl ) 

count: 5 

dev4: ib r d <C R> 

enter byte count: 10<CR> 

[0100] ( cmpl ) 

count: 10 

54 44 49 56 20 35 30 45 
2D 39 

dev4: ib.WJ.t<CR> 

enter string: “ cl;c p l?”< CR> 

[0100] ( cmpl ) 

count: 7 

dev4: ibrd<CR> 

enter byte count: 20<CR> 

[2100] ( end cmpl ) 

count: 1 1 

43 31 3A 43 50 4C 20 44 
35 30 0A 

dev4: q<£R> 

for quitting the program 



C 1 : C P L D 
5 0 ♦ 



T D I V 5 0 E 
- 9 
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EXAMPLE 2: 

GPIB PROGRAM FOR 
IBM PC (HIGH-LEVEL 
FUNCTION CALLS) 



The following BASICA program allows full interactive control of 
the 9420/24/50 using an IBM PC as GPIB controller. It is again 
assumed that the controller is equipped with a National Instru- 
ments GPIB interface card. All the remote control commands 
listed in Section 5 can be used by simply entering the text string of 
the command, i.e. “cl:vdiv 50 mv” (without the quotes). The pro- 
gram automatically displays the information sent back by the 
oscilloscope in response to queries. 

In addition, a few utilities have been provided for convenience. 
The commands ST and RC enable waveform data to be stored on 
or retrieved from disk if proper drive and file names are provided. 
The command LC returns the oscilloscope to local mode. Re- 
sponses sent back by the oscilloscope are interpreted as character 
strings and are thus limited to a maximum of 255 characters. 

Note 1: It is assumed that the National Instruments GPIB driver 
GPIB .COM is in its default state. This means that the interface 
board can be referred to by its symbolic name ’GPIBO’ and that 
devices on the GPIB with addresses 1 to 16 can be called by the 
symbolic name ’DEVI’ to ’DEVI 6’. 

Note 2: Lines 1-99 are a copy of the file DECL.BAS supplied by 
National Instruments. The first 6 lines are required for the initial- 
ization of the GPIB handler. DECL.BAS requires access to the file 
BIB.M during the GPIB initialization. BIB.M is one of the files 
supplied by National Instruments, and must exist in the directory 
currently in use. 

Note 3: The first 2 lines of DECL.BAS each contain a string 
“XXXXX” which must be replaced by the number of bytes which 
determine the maximum workspace for BASICA ( computed by 
subtracting the size of BIB.M from the currently available space in 
BASICA). For example, if the size of BIB.M is 1200 bytes and 
when BASICA is loaded it reports “60200 bytes free” , you would 
replace “XXXXX” by the value 59000 or less. 

Note 4: The default timeout of 10 seconds is modified to 300 msec 
during the execution of this program. However, the default value 
of the GPIB handler is not changed. Whenever a remote command 
is entered by the user, the program sends it to the instrument with 
the function call IBWRT. Afterwards, it always executes an IBRD 
call, independently of whether or not a response is expected. If a 
response is received it is immediately displayed. If there is no re- 
sponse, the program waits until time-out and then asks for the 
next command. 
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1-99 


<DECL . BAS> 






100 


CLS 






110 


PRINT "Control of the 9450 via GPIB and IBM 


PC" 




115 


PRINT "" 






120 


PRINT "Options : EX to exit LC local mode" 






125 


PRINT " ST store dataRC recall data" 




130 


PRINT "" 






140 


LINE INPUT "GPIB-address of oscilloscope (1. 


..16)? : " , ADDR$ 


145 


DEV$ = "DEV" + ADDR$ 




! 


150 


CALL IBFIND (DEV$ , SC0PE%) 




1 

■ 


155 


IF SC0PE% < 0 THEN GOTO 830 




i 

! 


160 


TMO% = 10 'timeout = 300 msec (rather than 


default 10 


sec) 


165 


CALL IBTMO ( SC0PE% , TMO%) 






170 


' 






200 


L00P% = 1 






205 


WHILE L00P% 






210 


LINE INPUT "Enter command (EX — > Exit) 


: " , CMD$ 




220 


IF CMD$ = "ex" OR Ch©$ = "EX" THEN LOOP% 


= 0 : GOTO 


310 


230 


IF CMD$ = »st" OR CMD$ = "ST" THEN GOSUB 


600 : GOTO 


300 


240 


IF CMD$ = "rc" OR CMD$ = "RC" THEN GOSUB 


700 : GOTO 


300 


250 


IF CMD$ = "lc" OR CMD$ = "LC" THEN GOSUB 


400 : GOTO 


300 


260 


IF CMD$ = »" THEN GOTO 300 






270 


CALL IBWRT ( SCOPES , CMD$ ) 






275 


IF IBSTA% < 0 THEN GOTO 840 






280 


GOSUB 500 






300 


WEND 






310 


GOSUB 400 






320 


END 






400 


✓ 






405 


'SUBROUTINE LOCAL_MODE 






410 


' 






420 


CALL IBLOC ( SC0PE%) 






425 


PRINT »" 






430 


RETURN 






500 


' 






505 


'SUBROUTINE GETJDATA 






510 


'If there are no data to read, simply wait until timeout occurs 


515 


' 






520 


CALL IBRD ( SC0PE% , RD$ ) 






525 


I = IBCNT% ' IBCNT% is the number of characters read 




530 


FOR J = 1 TO I 






535 


PRINT MID$ (RD$ , J, 1) ; 






540 


NEXT J 






545 


PRINT "" 






550 


RETURN 






600 


' 
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605 ' SUBROUTINE STOEE__DATA 

610 

615 RD1$=SPACE$ ( 3 ) 

620 LINE INPUT "Specify trace (EA , EB ,MC , MD , FE , FF , Cl , C2) : ".TRACES 

625 LINE INPUT "Enter filename : ".FILES 

630 CMD$="WFSU NP , 0 , SP , 0 , FP , 0 , SN , 0 ; CHDR SHORT" 

640 CALL IBWRT ( SCOPE% , CMD$ ) 

645 CMD$=TRACE$+" : WF? " 

650 CALL IBWRT ( SCOPE%, CMD$ ) 

660 CALL IBRD ( SCOPE% , RD1S ) 'Discard first 3 chars of response 

665 CALL IBRDF(SCOPE%, FILES) 

670 IF IBSTA% < 0 THEN GOTO 840 
675 PRINT "» 

680 RETURN 
700 

705 'SUBROUTINE RECALL_DATA 
710 

715 LINE INPUT "Specify target memory (MC.MD) : " , MEM$ 

720 LINE INPUT "Enter filename : ".FILES 
730 CMD$=MEM$+" : TRACE ON" 

735 CALL IBWRT ( SC0PE% , CMDS ) 

740 CALL IBWRTF(SCOPE%, FILES) 

745 IF IBSTA% < 0 THEN GOTO 840 
750 PRINT "" 

755 RETURN 
800 

810 'ERROR HANDLER 
820 

830 PRINT "IBFIND ERROR" 

835 END 

840 PRINT "GPIB ERROR — IBERR: " ; IBERR%; " IBSTA : " ; HEXS ( IBSTA%) 

845 END 1. 



EXAMPLE 3: 

GPIB PROGRAM FOR 
IBM PC (LOW-LEVEL 

FUNCTION CALLS) The following example has the same function as example 2, but it is 

written with low level function calls. 

The program assumes that the controller (board) and oscilloscope 
(device) are at addresses 0 and 4 respectively. The decimal listen- 
er and talker addresses of the controller and the device thus are: 

Listener address Talker address 

controller 32 (ASCII <space>) 64 (ASCII @) 

device 32+4=36 (ASCII $) 64+4=68 (ASCII D). 
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1-99 <DECL . BAS> 

100 CLS 

110 PRINT "Control of the 9450 (address 4) via GPIB and IBM PC" 

115 PRINT PRINT "Options : EX to exit LC local mode" 

120 PRINT " ST store data RC recall data": PRINT"" 

125 L0QP=1 

130 CMD1$ = "?_@$" 'Unlisten, Untalk, Board talker, Device listener 
135 CMD2$ = "?_ D" 'Unlisten, Untalk, Board listener, Device talker 
140 BDNAME$= "GPIBO" : CALL IBFIND (BDNAMES , BRD0%) 

145 IF BRD0% < 0 THEN GOTO 420 

150 CALL IBSIC (BRD0%) : IF IBSTA% < 0 THEN GOTO 425 
155 WHILE LOOP 

160 LINE INPUT "Enter command (EX — > Exit) : " , CMD$ 

165 V% = 1: CALL IBSRE (BRD0%, V%) 



170 


IF 


CMDS = 


"ex" 


OR 


CMDS = 


"EX" 


THEN 


LOOP - 


FALSE: GOTO 205 


175 


IF 


CMDS = 


"St" 


OR 


CMDS = 


"ST" 


THEN 


GOSUB 


285: 


GOTO 200 


180 


IF 


CMDS = 


"re" 


OR 


CMDS = 


"RC" 


THEN 


GOSUB 


365: 


GOTO 200 


185 


IF 


CMDS = 


"1c" 


OR 


CMDS = 


MJ If 


THEN 


GOSUB 


240 


GOTO 200 



190 IF CMD$ = »" THEN GOTO 200 

195 CALL IBCMD (BRD0% , CMD1$ ) : CALL IBWRT (BRD0% , CMD$ ) : GOSUB 270 

200 WEND 

205 CALL IBSIC (BRD0%) : V%=0 : CALL IBSRE (BRD0%, V%) 

210 CALL IBSIC (BRD0%) 

215 END 
220 

230 'LOCAL MODE 
235 

240 V% = 0: CALL IBSRE (BRD0% , V%) : PRINT »" 

245 RETURN 
250 

260 'SUBROUTINE GET_DATA 
265 

270 CALL IBCMD ( BRD0%, CMD2S ) : CALL IBRD (BRD0% , RD$ ) : I=IBCNT% 

275 FOR J=1 TO I: PRINT MID$ (RD$ , J , 1 ) ; : NEXT J: PRINT »" 

280 RETURN 
285 

290 'SUBROUTINE STORE_DATA 
295 

300 RD1$=SPACE$(3) 

305 LINE INPUT "Specify trace (EA, EB , MC , MD , FE , FF , Cl , C2) : ", TRACES 

310 LINE INPUT "Enter filename : ", FILES 
315 CALL IBCMD ( BRD0% , CMD1S ) 

320 CMD$="WFSU NP , 0 , SP , 0 , FP , 0 , SN , 0 ; CHDR SHORT" 

321 CALL IBWRT (BRD0%, CMDS) 

325 CMD$=TRACE$ + " : WF? " : CALL IBWRT (BRD0%,CMD$) 

330 CALL IBCMD (BRD0%, CMD2S ) : CALL IBRD (BRD0% , RD1S ) 
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335 CALL IBRDF (BRDO% , FILES ) 

340 IF IBSTA% < 0 THEN GOTO 430 
345 PRINT "" 

350 RETURN 
355 

360 ' SUBROUTINE RECALL_ DATA 

365 

370 LINE INPUT "Specify target memory (MC ,MD) : " , MEM$ 

375 LINE INPUT "Enter filename : ".FILES 
380 CALL I BCMD ( BRDO% , CMD1 $ ) 

385 CMOS =MEM$ + ": TRACE ON": CALL IBWRT(BRDO%, CMOS) 

390 CALL IBWRTF(BRDO%, FILES) 

395 IF IBSTA% < 0 THEN GOTO 430 
400 PRINT "" 

405 RETURN 
410 

415 ' ERROR HANDLER 

420 

425 PRINT "IBFIND ERROR": STOP 

430 PRINT "GPIB ERROR — IBERR : " ; IBERR%; "IBSTA : » ; HEXS ( IBSTA%) 
435 STOP 
440 END 
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THE WAVEFORM 
TEMPLATE 



This is the response of the instrument to a command of the form 
TMPL? 



TMPL " 

/00 

000000 LECROY_l_l : TEMPLATE 

8 66 109 

; Explanation of the formats of waveforms and their descriptors on the 
; LeCroy Digital Oscilloscopes, 

; Software Release 33.1.1.2, 89/08/24. 

; A descriptor and/or a waveform consists of one or several logical data blocks 
; whose formats are explained below. 

; Usually, complete waveforms are read: at the minimum they consist of 
; the basic descriptor block WAVEDESC 

; a data array block. 

; Some more complex waveforms, e.g. envelope data or the results of a Fourier 
; transform, may contain several data array blocks. 

; When there are more blocks, they are in the following sequence: 

; the basic descriptor block WAVEDESC 

; the history text descriptor block USERTEXT (may or may not be present) 

; the time array block (for RIS and sequence acquisitions only) 

; data array block 

; auxiliary or second data array block 

; With the exception of the data and time arrays, every block starts with 
; an 8-character name which identifies which kind of block it is. 

; In the following explanation, every element of a block is described by a 
; single line in the form 

; cbyte position> cvariable name>: cvariable type> ; <comment> 

; where 

; <byte position> = position in bytes (decimal offset) of the variable, 

; relative to the beginning of the block. 

; cvariable name> = name of the variable. 

; cvariable type> = string up to 16-character name 

; terminated with a null byte 

; byte 8-bit signed data value 

; word 16-bit signed data value 

; long 32-bit signed data value 

; float 32-bit IEEE floating point value 
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double 



enum 



time_stamp 



data 



text 

unit definition 



with the format shown below 
3 3 . . . 2 2 . . . bit 

1 0 3 2 0 position 

s exponent fraction 
where 

s = sign of the fraction 
exponent = 8 bit exponent e 
fraction = 23 bit fraction f 
and the final value is 
(_l)** s * 2**(e-127) * l.f 
64-bit IEEE floating point value 
with the format shown below 
6 6 . . . 5 5 . . . bit 

32 21 0 positon 

s exponent fraction 
where 

s = sign of the fraction 

exponent - 11 bit exponent e 

fraction = 52 bit fraction f 

and the final value is 

(-1) **s * 2** (e-1023) * l.f 

enumerated value in the range 0 to N 

represented as a 16-bit data value. 

The list of values follows immediately. 

The integer is preceded by an . 
double precision floating point number, 
for the number of seconds and some bytes 
for minutes, hours, days, months and year. 



double 


seconds 


(0.00 to 59.999999) 


byte 


minutes 


(0 to 59) 


byte 


hours 


(0 to 23) 


byte 


days 


(1 to 31) 


byte 


months 


(1 to 12) 


word 


year 


(0 to 16000) 


word 


unused 




There 


are 16 bytes 


in a time field. 



byte, word or float, depending on the 
read-out mode reflected by the WAVEDESC 
variable COMM_TYPE, modifiable via the 
remote command COMM_FORMAT. 
arbitrary length text string 
(maximum 400) 

a unit definition consists of a 48 character 
ASCII string terminated with a null byte 
for the unit name. 
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WAVEDESC : BLOCK 
> 

; Explanation of the wave descriptor block WAVEDESC ; 

» 

< 0> DESCRIPTOR_NAME: string ; the first 8 chars are always WAVEDESC 

< 16> TEMPLATE_NAME : string 

< 32> COMM_TYPE: enum ; chosen by remote command COMM_F ORM AT 

_0 byte 

_1 word 

endenum 

< 34> COMM_ORDER: enum 

_0 HIFIRST 

_1 LOFIRST 

endenum 

; The following variables of this basic wave descriptor block specify 
; the block lengths of all blocks of which the entire waveform (as it is 
; currently being read) is composed. If a block length is zero, this 
; block is (currently) not present. 



BLOCKS : 


36> 


WAVE_DESCRIPTOR: long 


length in bytes of block WAVEDESC 


40> 


USER_TEXT : long 


length in bytes of block USERTEXT 


44> 


RES_DESC1 : long 




ARRAYS : 


48> 


TRIGTIME_ARRAY: long 


length in bytes of TRIGTIME array 


52> 


RIS_TIME_ARRAY: long 


length in bytes of RIS_TIME array 


56> 


RES_ARRAY1: long 


an expansion entry is reserved 


60> 


WAVE_ARRAY_1 : long 


length in bytes of 1st simple 
data array. In transmitted waveform 
represent the number of transmitted 
bytes in accordance with the NP 
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< 64> WAVE_ARRAY_2 : long 



< 68> 


RES_ARRAY2 


long 


< 7 2> 


RES_ARRAY3 


long 


; The 


following variables 


identify the 


< 7 6> 


INSTRUMENT- 


NAME: string 


< 92> 


INSTRUMENT- 


_NUMBER : long 


< 96> 


TRACE_LABEL: string 


<112> 


RE SERVED 1 : 


word 


<114> 


RESERVED2 : 


word 


; The 


following variables 


describe the 



; which the waveform was generated. 
<11 6> WAVE_ARRAY_COUNT : long 



<120> PNTS_PER_SCREEN: long 

<124> FIRST_VALID_PNT: long 



<128> LAST_VALID_PNT: long 



<13 2> FIRST_POINT: long 



; parameter of the WFSU remote command 
; and the used format (see COMM_TYPE) . 

; length in bytes of 2nd simple 
; data array 



; 2 expansion entries are reserved 
instrument 



; identifies the waveform. 



; 2 expansion entries 
waveform and the time at 



; number of data points in the data 
; array. If there are two data 
; arrays (FFT or Envelope) , this number 
; applies to each array separately. 

; nominal number of data points 
; on the screen 

; count of number of points to skip 
; before first good point 
; FIRST_VALID_POINT = 0 
; for normal waveforms. 

; index of last good data point 
; in record before padding(blanking) 

; was started. 

; L A ST_V AL I D_PO I NT = WAVE_ARRAY_C0UNT-1 
; except for aborted sequence 
; and rollmode acquisitions 

; for input and output, indicates 
; the offset relative to the 
; beginning of the trace buffer. 
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; Value is the same as the FP parameter 
; of the WFSU remote command. 



<136> 


SPARSING_FACTOR: long 


for input and output, indicates 
the sparsing into the transmitted 
data block. 

Value is the same as the SP parameter 
of the WFSU remote command. 


<140> 


SEGMENT_INDEX: long 


for input and output, indicates the 
index of the transmitted segment. 
Value is the same as the SN parameter 
of the WFSU remote command. 


<144> 


SUBARRAY_COUNT : long 


actual number of subblocks within the 
data array, (to be used in sequences) 


<148> 


SWEEP S_PER_ACQ: long 


for RIS or Sequence, Averages,... 
it is the nominal number 


<152> 


NUMBER_RE JECTED : long 


number of sweeps rejected 
while doing averaging 


<156> 


VERTICAL_GAIN: float 




<160> 


VERTICAL_OFFSET: float 


to get floating values from raw data : 
VERTICAL_GAIN * data - VERTICAL_OFFSET 


<164> 


MAX_VALUE : float 


maximum allowed value. It corresponds 
to the upper edge of the grid. 


<168> 


MIN_VALUE : float 


minimum allowed value. It corresponds 
to the lower edge of the grid. 


<17 2> 


NOMINAL_BITS: word 


a measure of the intrinsic precision 
of the observation: ADC data is 8 bit 
averaged data is 10-12 bit, etc. 


<174> 


RESERVED7 : word 


expansion entry 


<176> 


HORIZ_INTERVAL: float 


; sampling interval for time domain 
; waveforms 


<180> 


HORI Z_OFFSET : double 


; trigger offset for the first sweep of 



the trigger, seconds between the 
trigger and the first data point 
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<188> PIXEL_OFFSET : double ; needed to know how to display the 

; waveform 



<196> 


VERTUNIT: 


unit_def ini t ion 


; units 


of 


the 


vertical axis 


<244> 


HORUNIT: 


unit_def inition 


; units 


of 


the 


horizontal axis 


<292> 


RESERVED3 


: word 










<294> 


RESERVED4 


: word ; 


2 expansion entries 



<296> 

<312> 



<316> 



<318> 



TRIGGER_TIME : time_stamp ; time of the trigger 

ACQ_DURATION : float ; duration of the acquisition (in sec) 

; in multi-trigger waveforms. 

; (e.g. sequence, RIS, or averaging) 

RECORD_TYPE: enum 
_0 single_sweep 

_l interleaved 

_2 histogram 

_3 trend 

_4 f ilter_coef f icient 

_5 complex_frequency_domain 

_8 extrema_-_envelope_display 

_7 sequence 

endenum 

PROCESS ING_DONE : enum 
_0 no_processing 

_1 f ir__f ilter 

_2 interpolated_waveform 

_3 sparsed__waveform 

_4 autoscaled_waveform 

_5 no_result_waveform 

_6 rolling_waveform 

_7 cumulative__waveform 

endenum 



<320> RESERVED5: word 

<322> RESERVED6: word ; 2 expansion entries 

; The following variables describe the basic acquisition 
; conditions used when the waveform was acquired 
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<324> 



TIMEBASE: enum 



_0 


l_ps/div 


_1 


2_ps/div 


_2 


5_ps/div 


_3 


10_ps/div 


_4 


20_ps/div 


_5 


50_ps/div 


_6 


100_ps/div 


_7 


200_ps/div 


_8 


500_ps/div 


_9 


l_ns/div 


_10 


2_ns/div 


_11 


5_ns/div 


__1 2 


10_ns/div 


_1 3 


20_ns/div 


_14 


50_ns/div 


_15 


100_ns/div 


_1 6 


200 ns/div 


_17 


500_ns/div 


_ 18 


l_us/div 


_19 


2_us/div 


_20 


5_us/div 


_21 


10_us/div 


_22 


20_us/div 


_23 


50_us/div 


_24 


100_us/div 


_25 


200_us/div 


_26 


500_us/div 


_27 


l_ms/div 


_28 


2_ms/div 


_29 


5_ms/div 


_30 


10_ms/div 


_31 


20_ms/div 


_3 2 


50_ms/div 


__3 3 


100_ms/div 


_34 


200_ms/div 


_35 


500_ms/div 


_36 


l_s/div 


_37 


2_s/div 


_38 


5_s/div 


_39 


10_s/div 


_40 


20_s/div 


_41 


50_s/div 


_42 


100_s/div 


_43 


200_s/div 


_44 


500_s/div 
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<326> 



<328> 

<332> 



_45 l_ks/div 
_46 2_ks/div 
_47 5_ks/div 
_100 EXTERNAL 
endenum 

VERT_COUPL I NG : enum 
_0 DC_50_0hms 

_1 ground 

_2 DC_lMOhm 

_3 ground 

_4 AC , __lMOhm 

endenum 

PROBE_ATT : float 

FIXED__VERT_GAIN : enum 

_0 l_uV/div 

_1 2_uV/div 

_2 5_uV/div 

_3 10_uV/div 

_4 20_uV/div 

_5 50_uV/div 

_6 100_uV/div 

_7 200_uV/div 

_8 500_uV/div 

_9 l_mV/div 

_10 2_mV/div 

_11 5_mV/div 

_12 10_mV/div 

_13 20_mV/div 

_14 50_mV/div 

_15 100_mV/div 

_1 6 200_mV/div 

_17 500_mV/div 

_18 l_V/div 

_19 2_V/div 

_20 5_V/div 

_21 10_V/div 

_22 20_V/div 

_23 50_V/div 

_24 100_V/div 

_25 200_V/div 

_26 500_V/div 

_27 l_kV/div 

endenum 



192 




Appendix B 



<334> 

endenum 

<336> 

<340> 

<344> 



/OO 



BANDWIDTH_LIMIT: enura 
_0 off 

_1 on , _80_MHz 



VERTICAL_VERNIER: float 

ACQ_VERT_OFFSET: float 

WAVE_SOURCE: enum 
_0 CHANNEL_1 

_1 CHANNEL_2 

_2 CHANNEL_3 

__3 CHANNEL_4 

_9 UNKNOWN 

endenum 

ENDBLOCK 



USERTEXT: BLOCK 

; Explanation of the descriptor block USERTEXT at most 400 bytes long. 

< 0> DESCRIPTOR_NAME : string ; the first 8 chars are always USERTEXT 

< 16> TEXT: text ; this is simply a list of ASCII 

; characters 

/OO ENDBLOCK 



SIMPLE: ARRAY 



Explanation of the simple data array 

The data item is repeated for each acquired or computed data point 
of the first data array of any waveform. 



< 0 > 



MEASUREMENT: data 



the actual format of a data is 
given in the WAVEDESC descriptor 
by the COMM_TYPE variable. 
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/OO ENDARRAY 




DATA_ARRAY 1: ARRAY 



; Explanation of the data__array_l array. 

; The data item is repeated for each acquired or computed data point 
; of the first data array of any waveform. 

; It is identical to SIMPLE above. 

< 0> MEASUREMENT: data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
; by the COMMJTYPE variable. 



/OO ENDARRAY 




DATA_ARRAY_2 : ARRAY 

; Explanation of the data_array_2 array. 

; The data item is repeated for each acquired or computed data point 
; of the second data array of any dual waveform 
; e.g. the imaginary part of a FFT . 

< 0> MEASUREMENT: data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
; by the COMMJTYPE variable. 



/OO ENDARRAY 




DUAL: ARRAY 



; Explanation of the dual array. 

; This data block is repeated for each pair of computed data points 
; composing respectively the first and second data array of a waveform, 
; e.g the real and imaginary parts of an FFT. 

< 0> MEASUREMENT_1 : data ; data in the first data array. 
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< o> 



/oo 



MEASUREMENT 2: data 



the actual format of a data is 
given in the WAVEDESC descriptor 
by the COMM_TYPE variable. 

data in the second data array 
the byte offset depends on 
the actual format of the data which 
is given in the WAVEDESC descriptor 
by the COMM_TYPE variable. 



ENDARRAY 



TRIGTIME: ARRAY 

; Explanation of the trigger time array 

; This data block is repeated for each segment which makes up the acquired 



; sequence 


record. 




A - 

o 

V 


TRIGGER_TIME: double 


; for sequence acquisitions, 
; time in seconds from first 
; trigger to this one 


A - 

00 

V 


TRIGGER_OFFSET: double 


; the trigger offset is in seconds 
; from trigger to zero'th data point 


/OO 


ENDARRAY 





RISTIME: ARRAY 

; Explanation of the random-interleaved-sampling (RIS) time array 
; This data block is repeated for each sweep which makes up the RIS record 

< Q> RIS_OFFSET: double ; seconds from trigger to zero'th 

; point of segment 

/OO ENDARRAY 



000000 ENDTEMPLATE 
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This index does not contain entries for each of the remote commands. They can be found in 
alphabetical order in section 5. Furthermore, the index does not contain references to the com- 
mand descriptions in section 5. 



A 

Assistance, 1 

B 

BASIC (A), 15-22, 161, 180 
Binary Blocks, 163 

r 

CMR - CoMmand error Register, 171, 173, 
174, 176 

Command Execution, 37 
Command Notation, 37—38 
Command Summary, 35—36 
Commands and Queries, 4, 6—9 
Continuous Polling, 21 
Controller Timeout, 4, 13, 19, 22, 180 
Customer Service, 1—2 

D 

Data 

Arrays, 159, 160 
ASCII forms, 7-9 
Blocks, 159 

Formatting, 161, 163, 168 
HEX mode, 29, 33, 162, 168 
Horizontal position, 165—167 
Interpretation, 162—165 
Sparsing, 168 
Time of, 165—167 
Values, 161, 163-166 



DDR - Device Dependent error status Regis- 
ter, 176 

Descriptor 

Block, 159, 163 
Values, 161, 163 

Diagnostics Help Messages, 4 

DUAL, 160, 161 

E 

Error Messages, 4 

ESE - Standard Event Status Enable regis- 
ter, 20, 171, 173, 175 

ESR - Standard Event Status Register, 20, 
171-174 

EXR - Execution error Register, 171, 176 

G 

GPIB, 11 

Address switches, 3, 12, 25 

ATN - ATteNtion, 12 

Data lines, 12 

DCL - Device CLear, 14 

EOI - End Or Identify, 5, 13 

GET - Group Execute Trigger, 14, 19 

GTL - Go To Local, 14, 18 

Handshake lines, 12 

Hard copies, 25—27 

Hardware Configuration, 15 

IEEE 488.1, 3, 13-15, 24 

IEEE 488.2, 3, 13, 171, 174 

1FC - InterFace Clear, 12, 15 

Interface capabilities, 11 
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Interface management lines, 12—13 
Listener address, 24 
LLO - Local LOckout, 14 
MLA - Listen address, 12, 24, 27 
MTA - Talker address, 12, 24, 27 
Polling, 21-25 

Programs for GPIB, 15—18, 21—26, 
179-182 

REN - Remote ENable, 13, 14 

RQS - ReQuest for Service, 22 

SDC - Selected Device Clear, 14, 18 

Signals, 12—13 

Software Configuration, 15 

SRE - Service Request Enable register, 

19, 22 

SRQ - Service ReQuest, 13, 19—20 
Talker address, 24 
Transfers, 15 

UNL - Universal unlisten, 12, 24—25, 27 
UNT - Universal untalk, 12, 24-25, 27 

H 

Hard Copies. See GPIB 
Header, 6—7 
Header Path, 7 
Help Messages, 4 

I 

IBCLR, 18 
IBCMD, 23 
IBFIND, 16 
IBLOC, 18 
IBRD, 16 
IBRDF, 18 
IBRDI, 18-19 
IBRPP, 24 



IBRSP, 22 

IBTMO, 19 

IBTRG, 19 

IBWAIT, 19, 22 

IBWRT, 16 

IBWRTF, 18 

IBWRTI, 18-19 

IEEE Standards. See GPIB 

INE -- INternal state change Enable register, 

20, 22, 23, 25, 171, 173, 176 

INR - INternal state change Register, 20, 

21, 22, 23, 25, 171, 173, 175 

INSPECT? Queries, 160-162 
Interface Messages, 11 
1ST Polling, 24-25, 173, 175 

L 

Line Splitting. See RS-232-C 

Local State, 5 

Logical Data Blocks, 159 

M 

Maintenance, 1 

P 

PaRallel poll Enable register. See PRE 
Parallel Polling, 23—24 
Pin Assignments. See RS-232-C 
Polling, 21-25 

PRE - PaRallel poll Enable register, 23, 24, 
173, 175 

Program Messages, 3—4, 5—6 
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R 

RAN - Return Authorization Number, 2 
Remote State, 5 
Response Message Form, 9—10 
Return Procedure, 2 
RISTIME, 160, 167 
RS-232-C, 29 
Configuration, 30 
Echoing, 30 
Editing, 31 

Handshake control, 30—31 
Immediate commands, 30 
Line splitting, 32—33 
Message terminators, 31 
Pin assignments, 29—30 
Simulating GPIB commands, 33 
SRQ - Service request, 32 

s 

Serial Polling, 22 
Service Procedure, 2 
Service Requests, 171—173 
SIMPLE, 160 

SRE - Service Request Enable register, 19, 
171, 173, 175 

SRQ - Service ReQuest, 19—21, 32, 
173-174 

Standard Event Status Enable Register. See 
ESE 

Standard Event Status Register. See ESR 



Status Register Reporting, 171 

STB - STatus Byte register, 20—25, 32, 
171-174 

Suffix Multipliers, 8—9 

T 

Template, 159, 160, 163, 164, 165, 
185-195 

Terminators, 5, 9, 31, 164 
Thumbwheel Switch. See GPIB Address 
Switches 

Transfers. See GPIB 
Trigger Time, 160 
TRIGTIME, 159, 166 

u 

URR - User Request status Register, 20, 
176 

USERTEXT, 159 

w 

Warning Messages, 4 
Warranty, 1 

WAVEDESC. See Descriptor 
WAVEFORM 
Command, 167 
Query, 162-167, 168 
Transfer Optimization, 168—169 
Waveform Template, 185—195 
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US SALES OFFICES 

800-5-LeCroy (automatically connects you 
to your local sales office) 

WORLDWIDE 

Argentina: Search SA, (01) 394-5882 

Australia: Scientific Devices Pty.Ltd, 

(03) 579-3622 

Austria: Dewetron Elek. Messgerate GmbH, 
(0316) 391804 

Benelux: LeCroy B.V., 31-4902-89285 
Brazil: A. Santos, (021) 233 5590 

Canada: Rayonics, W. Ontario: 

(416) 736-1600 

Rayonics, E. Ontario/Manitoba: 

(613) 521-8251 

Rayonics, Quebec: 

(514) 335-0105 
Rayonics, W. Canada: 

(604) 293-1854 

Denmark: Lutronic, (42) 459764 
Finland: Labtronic OY, (90) 847144 
France: LeCroy Sari (1) 69073897 

Germany: LeCroy GmbH, (06221) 49162 
(North) (0405) 42713 

Greece: Hellenic S/R Ltd., (01) 721 1140 
India: Electronic Ent., (022) 4137096 
Israel: Ammo, (03) 453157 

Italy: LeCroy S.r.l.,Roma (06) 302-9646 
Milano (02) 2940-5634 
(02) 204 7082 

Japan: Toyo Corp., (03) 279 0771 

Korea: Samduk Science & Ind., Ltd.: 

(02) 468 04914 

Mexico: Nucleoelectronica SA: 

(905) 593 6043 



New Zealand: E.C. Gough Ltd., 

(03) 798-740 

Norway: Avantec A/S, (02) 630520 

Pakistan: Electronuclear Corp., 

(021) 418087 

Portugal: M.T. Brandao, Lta., 

(02) 691116 

Singapore: Singapore Electronics and 
Eng. Ltd., (065) 481 8888 

Spain: Anadig Ingenieros SA, 

(01) 433 2412 

Sweden: MSS AB, (0764) 68100 

Switzerland: LeCroy S.A. 

(022) 719 21 11 

Taiwan: Topward El. Inst., Ltd., 

(02) 601 8801 

Thailand: Measuretronix Ltd., 

(02) 374 2516 

United Kingdom: LeCroy Ltd., 

(0235) 33 114 

LeCROY 

CORPORATE HEADQUARTERS 

700 Chestnut Ridge Road 
Chestnut Ridge, NY 10977-6499 
Telephone: (914) 578 6097 
TWX:(710) 577-2832 
Fax: (914) 425-8967 

LeCROY 

EUROPEAN HEADQUARTERS 

2 chemin Pre-de-la-Fontaine 
P.O. Box 341 

1217 Meyrin 1/Geneva, Switzerland 
Tel.: (022) 719 21 11 Telex: 419 058 
Fax: (022) 782 39 15 



